AMIGA-CD 2

home *** CD-ROM | disk | FTP | other *** search

/ AMIGA-CD 2 / Amiga-CD - Volume 2.iso / neue_programme / gfx / edit / tsmorph / tsmorph.doc < prev next >

Wrap

Text File | 1995-06-01 | 161KB | 5,230 lines

TSMorph.guide TSMorph 3.2 Contents ******************** Overview Quick overview Installation Installation instructions Requirements Software and Hardware required Parameters Tool types and Shell parameters Info Window The information window Control Window The control window Edit Windows The point edit windows Edit Modes Point editing modes Requesters Requesters which appear Interface Changing the interface File Format Internal file formats ARexx ARexx interface to TSMorph-render and TSMorph Algorithms Morphing algorithms File Names File naming Error Messages Error Messages Bugs Known (and unknown) errors Hardware&Software Hardware and Software used in development History Version History (since 2.0) Hints & Tips Some useful hints and tips Distribution Copyright and distribution requirements Index The index for this guide TSMorph.guide/Overview Quick overview ************** For a quick tutorial see Tutorial/Tutorial.readme. TSMorph is a set of morphing programs. It consists of two programs: TSMorph Edit the Morph parameters TSMorph-render Generate the morphed images TSMorph is used to create a parameter file which is used by TSMorph-render to produce the morphed images. TSMorph-render works with 24 bit internally. Run times can be about 3 seconds per frame for a 150x150 image on a 28Mhz 68040 - See Benchmarks. TSMorph-render can be used to morph one image to another in a set number of frames with a number of control points, just distort one image with control points. It can also be used to morph or warp a series of images (e.g. to morph between two animations). When TSMorph is run without parameters it will display an ASL file requester for a file created by TSMorph, it will then create the images, displaying a Progress Requester on the default (or named) public screen allowing the process to be interrupted and/or stopped. ARexx scripts are run before and after each image is processed, and also before each image is loaded. These allow the changing of movement and colour to be controlled along with the ability to only generate some frames, and also pre and post image processing (e.g. to change to a non-24-bit format and build an animation). TSMorph is used to generate the parameter file. When run it displays an Information Window on a public screen. This allows the input of the file names to morph between, the number of frames, the start frame, the output file names, and the type of morph (single or dual images) to be changed. It also allows the editing of control points on the images. The images (most image formats can be loaded - See OPENMODE ) are displayed on a public screen in resizeable, scrollable windows. When the images are displayed control points can be edited in various modes. These modes allow the addition, deletion, linking and unlinking of the control points. Context sensitive help is displayed using amigaguide (if available). The Help key can be pressed in the gadgets, over the gadgets, on menus or anytime a window is active. TSMorph is ©1993/94 Topicsave Limited. The author can be contacted by EMail as mark@topic.demon.co.uk or mpaddock@cix.compulink.co.uk. TSMorph.guide/Installation Installation instructions ************************* If you wish to use Installer then TSMorph can be installed using the supplied script. If not then the following is a description of what the script does. * 1) Make a new drawer for the executables - default Work:TSMorph, * 2) Copy TSMorph, TSMorph-render, TSMorph.doc, TSMorph.guide, TSMorph-prefs and the Rexx drawer and its contents and all their icons to the drawer created in 1) above (if you have a 68020/030 with 68881/2 then copy the FPU version TSMorph-render.881 and rename it as TSMorph-render instead of copying TSMorph-render, or if you have a 68040 then copy the 040 version TSMorph-render.040 and rename it as TSMorph-render instead of copying TSMorph-render) * 3) If required copy the Brush and Cursor drawers and contents. * 4) Make new drawers ENVARC:TSMorph and ENV:TSMorph, * 5) Copy the default Icons to the directories created above. * 6) Amend your s:user-startup to assign TSMorph: to the drawer created in step 1). * 7) Manually perform the assign in step 6). * 8) If you are running system version 3.0 (or greater) change the default tool for TSMorph.guide to MultiView. * 9) If required copy the Tutorial directory to TSMorph:. * 10) If required copy the HTML directory to TSMorph:, also copy the View_HTML icon and use an editor to make the file contain: CD HTML Path:Mosaic file://localhost/TSMorph:html/TSMorph.html Where Path:Mosaic is the location of your version of Mosaic. The following files are included in this distribution: COPYING GNU General Public License TSMorph-render.881 The rendering program 68020/68881 version TSMorph-render.881.info Icon TSMorph-render.040 The rendering program 68040 version TSMorph-render.040.info Icon TSMorph The parameter set up program TSMorph.info Icon TSMorph-prefs Preferences editor TSMorph-prefs.info Icon TSMorph-render The rendering program TSMorph-render.info Icon TSMorph.doc Documentation in plain text format TSMorph.doc.info Icon TSMorph.guide Documentation in amigaguide format TSMorph.guide.info Icon Install Installation script for Installer Install.info Icon Installer Commodore Installer Read.Me Short read me file Read.Me.info Icon View_HTML.info Icon HTML/#? .html files HTML/Images/#? .html images Env.info Icon Env/TSMorph.info Icon Env/TSMorph/def_points.info Default project Icon Env/TSMorph/def_bw16.info Default 16 colour grey Icon Env/TSMorph/def_bw256.info Default 256 colour grey Icon Env/TSMorph/def_ham6.info Default HAM 6 Icon Env/TSMorph/def_ham8.info Default HAM 8 Icon Env/TSMorph/def_dctv3.info Default DCTV 3 plane Icon Env/TSMorph/def_dctv4.info Default DCTV 4 plane Icon Env/TSMorph/def_iff.info Default OpalVision IFF Icon Env/TSMorph/def_ilbm.info Default 24 bit ILBM Icon Env/TSMorph/def_jpg.info Default OpalVision JPEG Icon Env/TSMorph/def_ppm.info Default PPM Icon Env/TSMorph/def_prefs.info Default prefs Icon Rexx.info Icon Rexx/FadeToBlack.TSM Example prescript script Rexx/FadeToBlack.TSM.info Icon Rexx/FadeToWhite.TSM Example prescript script Rexx/FadeToWhite.TSM.info Icon Rexx/Loadscript.TSM Example loadscript script Rexx/Loadscript.TSM.info Icon Rexx/PixelMorph.TSM Example prescript script Rexx/PixelMorph.TSM.info Icon Rexx/PixelWarp.TSM Example prescript script Rexx/PixelWarp.TSM.info Icon Rexx/PostAnim.TSM Example postscript script Rexx/PostAnim.TSM.info Icon Rexx/Postscript.TSM Example postscript script Rexx/Postscript.TSM.info Icon Rexx/PreAll.TSM Example prescript script Rexx/PreAll.TSM.info Icon Rexx/PreAnim.TSM Example preview script Rexx/PreAnim.TSM.info Icon Rexx/Prescript.TSM Example prescript script Rexx/Prescript.TSM.info Icon Rexx/Preview.TSM Example preview script Rexx/Preview.TSM.info Icon Rexx/ToHam.TSM Example postscript script Rexx/ToHam.TSM.info Icon Tutorial.info Icon Tutorial/cat.pic Cat IFF image Tutorial/girl.pic Girl IFF image Tutorial/Tutorial.readme Tutorial instructions Tutorial/Tutorial.readme.infoIcon Brush.info Icon Brush/1st Brush Brush/1st.info Icon Brush/Add Brush Brush/Add.info Icon Brush/Del Brush Brush/Del.info Icon Brush/Goto Brush Brush/Goto.info Icon Brush/Last Brush Brush/Last.info Icon Brush/Link Brush Brush/Link.info Icon Brush/Next Brush Brush/Next.info Icon Brush/None Brush Brush/None.info Icon Brush/one Brush Brush/one.info Icon Brush/Prev Brush Brush/Prev.info Icon Brush/Rel Brush Brush/Rel.info Icon Brush/Two Brush Brush/Two.info Icon Brush/Unlink Brush Brush/Unlink.info Icon Cursor.info Icon Cursor/XAdd Pointer Cursor/XAdd.info Icon Cursor/XDel Pointer Cursor/XDel.info Icon Cursor/XL1 Pointer Cursor/XL1.info Icon Cursor/XL2 Pointer Cursor/XL2.info Icon Cursor/XMov Pointer Cursor/XMov.info Icon Cursor/XOne Pointer Cursor/XOne.info Icon Cursor/XRel Pointer Cursor/XRel.info Icon Cursor/XTwo Pointer Cursor/XTwo.info Icon Cursor/XU1 Pointer Cursor/XU1.info Icon Cursor/XU2 Pointer Cursor/XU2.info Icon TSMorph.guide/Requirements Software and Hardware required ****************************** The following libraries (with minimum version) are required to run TSMorph: intuition.library 37 iffparse.library 37 graphics.library 37 layers.library 37 gadtools.library 37 asl.library 37 utility.library 37 diskfont.library 36 icon.library 37 rexxsyslib.library 0 The following will also be used if present: amigaguide.library 34 dctv.library 3 opal.library 0 Note: OpalVision board is not required reqtools.library 38 reqtools is ©1991/1992 Nico François This is required for Animated Warps/Morphs nofrag.library 2 nofrag is © Copyright 1991 Jaba Development. egs.library 0 EGS is © Copyright 1990/93 VIONA Development. egsintui.library 0 egsgfx.library 0 egsrequest.library 0 TSMorph-render requires a large amount of chip memory (or opal.library). If you have 1Mb then 512x512 images can be morphed (though you may have to run workbench on a 2 colour 640x200 screen). 640x512 is probably impossible without 2Mb of chip memory. The amount of chip memory required by TSMorph can be reduced to 1/5 by setting the ZOOM parameter to OFF. TSMorph.guide/Par Tool types and Shell parameters ******************************* Both TSMorph and TSMorph-render can be run from the Shell or the Workbench. Most parameters can be edited using the Settings menu. Note: TSMorph and TSMorph-render both require a stack size of more than 4096. 8192 should be OK. If the stack is not set large enough then the programs will probably just crash. Parameters can be supplied, normally either on the Shell command line, as Icon Tool Types on the Project, TSMorph or TSMorph-render Icon, or in a settings file. The format of settings files is a text file with lines in the format: Settingstype=settingsvalue Blank lines or lines starting with a ; (semi-colon) are treated as comments. Any settings supplied on the Shell command line or as an Icon Tool Type override values specified in this file. Parameters on the Project Icon override parameters on the Tool Icon. Note: All the Project Icon tool types are used if the project is run with a default tool or by double clicking a tool, some are not used if the project is selected using a file requester, if the Tool was run from the Shell then file requester selected project tool types are ignored. Also some settings can not be changed on open projects, The Settings file name used is first file found from: 1) The name supplied in the SETTINGS= parameter on the project. 2) The name supplied in the SETTINGS= parameter on the tool. 3) TSMorph.prefs in the project directory for the workbench, the current directory from the Shell. 4) TSMorph.prefs in the directory TSMorph was loaded from. 5) ENV:TSMorph/TSMorph.prefs Unless KEEPSETTINGS is set to NO current settings are saved in ENV:TSMorph/TSMorph.prefs when TSMorph is quit. Settings can be saved and loaded from the Settings menu. TSMorph-prefs Preferences editor TSMorph Parameters to TSMorph TSMorph-render Parameters to TSMorph-render TSMorph.guide/Par-TSMorph Parameters to TSMorph ===================== The following parameters can be supplied, normally either on the Shell command line, as Icon Tool Types on the Project or TSMorph Icon, or in a settings file: CHANGEPALETTE Change screen palette to match image CREATEICONS Create project Icons CREATEICONSP Create prefs Icons CUSTOMDEPTH Custom screen depth CUSTOMMODE Custom screen mode EGS Use EGS for image windows FILES Specify file to open HELP Display continuous help KEEPSETTINGS Save settings on Quit OPENMODE How to open images PREVIEW ARexx script to preview image PUBSCREEN Public screen to use REQTOOLS Use Reqtools.library? SETTINGS Settings file name ZOOM Zoom image 2 times TSMorph.guide/P-CHANGEPALETTE CHANGEPALETTE=YES/NO/OFF ------------------------ Sets the default value of the Change Palette? settings menu item - defaults to YES. This item toggles if each images palette should be used to display the image when the window is active. Each image window can have its own palette. This option operates with the OPENMODE parameter. Since the ability to change screens colour palettes is not supported by CBM this menu option can be disabled by setting this parameter to OFF. TSMorph.guide/P-CREATEICONS CREATEICONS=YES/NO ------------------ Sets the default value of the Create Icons? settings menu item - defaults to YES. This item toggles if Icons are to be saved with parameter files. If it is selected then an Icon will be saved. The icon will come from ENV:TSMorph/def_points if this exists, secondly from ENV:SYS/def_points, otherwise the default project Icon is used. This parameter is not changed by Requester loaded projects. TSMorph.guide/P-CREATEICONSP CREATEICONSP=YES/NO ------------------- Sets the default value of the Create Prefs Icons? settings menu item - defaults to YES. This item toggles if Icons are to be saved with Settings files. If it is selected then an Icon will be saved. The icon will come from ENV:TSMorph/def_prefs if this exists, secondly from ENV:SYS/def_prefs, otherwise the default project Icon is used. TSMorph.guide/P-CUSTOMDEPTH CUSTOMDEPTH=4 ------------- This gives the depth of the custom screen to open if CUSTOMMODE is specified. It can be changed using the menu item (if reqtools.library is available), a requester is displayed allowing the input of the screen mode, but any change is ignored until TSMorph is reloaded. The default value is 4. TSMorph.guide/P-CUSTOMMODE CUSTOMMODE=screen_mode ---------------------- This gives the mode of the custom screen to open. The mode is as show in the Screen Mode requester - case is ignored (e.g. "PAL:Low Res"). This parameter is not changed by Requester loaded projects. The name of the screen must be given by the PUBSCREEN parameter. The depth is given by the CUSTOMDEPTH parameter. The screen will mostly clone the Workbench, but other colours will be set up as a grey scale. It can be changed using the menu item (if reqtools.library is available), a requester is displayed allowing the input of the screen mode, but any change is ignored until TSMorph is reloaded. The default value is nothing which means do not open a custom screen. TSMorph.guide/P-EGS EGS=YES/NO ---------- This controls the use of EGS when displaying the edit windows. See requirements for library requirements. If set to yes then the edit windows and relevent error requesters are displayed on the default EGS screen. ZOOM is always set to OFF when using EGS. OPENMODE may also be ignored in some circumstances. This parameter is not available as a menu option, is not saved in settings files and can not be specified on a project Icon. Default values is NO. TSMorph.guide/P-FILES FILES=filename -------------- This is only relevant to the Shell, only one name can be supplied - default is to open a new unnamed project. TSMorph.guide/P-HELP HELP=YES/NO ----------- Sets the default value of the Continuous Help? settings menu item - defaults to NO. This option has more effect when running release 3.0 or later. When set to YES help is continuously displayed using amigaguide (if available). TSMorph.guide/P-KEEPSETTINGS KEEPSETTINGS=YES/NO ------------------- Sets the default value of the Keep Settings? settings menu item - defaults to YES. By default current settings are saved in ENV:TSMorph/TSMorph.prefs when TSMorph is quit. This parameter and menu item enable this behaviour to be turned off. TSMorph.guide/P-OPENMODE OPENMODE=ALWAYS/IFILBM/IFCOLOURS/REMAP/OPAL ------------------------------------------- This parameter and menu item specify how images should be loaded for displaying by TSMorph. * ALWAYS - Only try and load normal ILBM images. Fail if not. The CHANGEPALETTE parameter has an affect on the image display. * IFILBM - First try to load as an ILBM image, load and remap the image if the image is not an ILBM or has 24 planes. * IFCOLOURS - As IFILBM but remap if the number of planes in the image exceed the number of the screen. * REMAP - Loads most ILBM (including 24 bit, EHB, HAM6, HAM8 and DCTV (with dctv.library [REMAP needs to be specified to correctly display DCTV images]), JPEG, TARGA, PPM and GIF. For JPEG if CHANGEPALETTE=YES or NO and the screen (see PUBSCREEN ) has more than 2 bit planes then the image is remapped to a dynamic type palette. Otherwise the image is remapped to the screen palette. If this fails then opal.library will be used (if present). This may be required for some JPEGs. * OPAL - Always use opal.library to load the image. This is probably only useful to load images in Opal FAST IFF format. The images are remapped to the current palette. When loading and remapping complex images a requester is displayed with a title of Loading Image, a text gadget giving progress messages, a Pass gadget, and a third progress gadget. There is no way of interrupting the load process. For slow machines it is suggested that you convert the images to ILBMs and specify ALWAYS. TSMorph.guide/P-PREVIEW PREVIEW=scriptname ------------------ This specifies the name of an ARexx script to run to preview the rendered image. The default script is Rexx/Preview. The version supplied renders the image as a 16 colour grey scale with a resolution of about 128/64 and displays it. It can be changed using the menu item (if reqtools.library is available), a requester is displayed allowing the input of the value. TSMorph.guide/P-PUBSCREEN PUBSCREEN=pubscreenname ----------------------- This gives the name of the Public Screen on which to open all TSMorph windows - default is the default public screen. This parameter is not changed by Requester loaded projects. It can be changed using the menu item (if reqtools.library is available), a requester is displayed allowing the input of the screen name, but any change is ignored until TSMorph is reloaded. If CUSTOMMODE is supplied as well then a public screen of this name is opened. TSMorph.guide/P-REQTOOLS REQTOOLS=YES/NO/ALL ------------------- This controls the use of reqtools.library. If set to NO then reqtools will not be used (except in very unusual circumstances). It will still however be opened and closed. If set to YES then reqtools will be used for various requesters. If set to ALL then it will be used for the File Requesters as well. This parameter is not available as a menu option, is not saved in settings files and can not be specified on a project Icon. Default values is YES. TSMorph.guide/P-SETTINGS SETTINGS=filename ----------------- This can only be supplied on the Shell command line, or an Icon Tool Type. It specifies the name of a file for more parameters. See parameters. This parameter is not changed by Requester loaded projects. TSMorph.guide/P-ZOOM ZOOM=YES/NO/OFF --------------- Sets the default value of the Zoom? settings menu item. If set to YES then images will be initially displayed 2x normal size, if set to NO then images will be initially displayed normal size, setting to OFF disables the Zoom? option, this reduces chip memory usage to 1/5 - defaults to NO. TSMorph.guide/Par-TSMorph-render Parameters to TSMorph-render ============================ The following parameters can be supplied, normally either on the Shell command line, as Icon Tool Types on the Project or TSMorph-render Icon, or in a settings file: ANTIALIAS Anti-Alias the output files CREATEICONSR Create image Icons DEPTH Depth for search algorithm DX Horizontal Pixelation DY Vertical Pixelation EGS Render to EGS window as well FILES Specify file to open INTEGER Integer render calculation LOADSCRIPT Script before each image loaded MODE Mode for rendering algorithm POSTSCRIPT Script after rendering frame PRESCRIPT Script before rendering frame PUBSCREENR Public screen to use QUALITY JPEG Quality REQTOOLS Use Reqtools.library? SAVEFORMAT Format to save images SETTINGS Settings file name TOOLPRI Priority of TSMorph-render TSMorph.guide/P-ANTIALIAS ANTIALIAS=NO/YES ---------------- This parameter and menu item select if the output files should be Anti-Aliased. Setting to YES can improve the quality of the images but will slow down the rendering process. This parameter is ignored if INTEGER is set to YES. Default value is NO. TSMorph.guide/P-CREATEICONSR CREATEICONSR=NO/YES ------------------- This parameter and menu item selects if Icons are to be saved with image files. If it is YES then an Icon will be saved. The icon depends on the save format. ENV:TSMorph/def_bw16 - 16 colour grey scale images ENV:TSMorph/def_bw256 - 256 colour grey scale images ENV:TSMorph/def_ham6 - HAM 6 images ENV:TSMorph/def_ham8 - HAM 8 images ENV:TSMorph/def_dctv3 - DCTV 3 plane images using dctv.library ENV:TSMorph/def_dctv4 - DCTV 4 plane images using dctv.library ENV:TSMorph/def_iff - 24 bit ILBM saved using opal.library ENV:TSMorph/def_ilbm - 24 bit ILBM saved without opal.library ENV:TSMorph/def_jpg - JPEG files saved using opal.library ENV:TSMorph/def_ppm - PPM files If the file does not exist then ENV:SYS/def_ilbm (etc.) is tried, if this does not exist then the default project Icon is used. Default value is NO. TSMorph.guide/P-DEPTH DEPTH=number ------------ This parameter indicates how deep the Morphing algorithm should search to find the points to use for morphing. The maximum value is 20 (higher values are accepted but will be taken as 20). Default value is 2. It can be changed using the menu item (if reqtools.library is available), a requester is displayed allowing the input of the value. TSMorph.guide/P-DX DX=number --------- This parameter can be used to speed up the rendering process. The default value is 0. If set to a number then only some Horizontal pixels will be generated. e.g. if set to 3 then only every 4th pixel will be generated. The others will be copied from the previous pixel. This can be overridden by using ARexx. Also see DY. It can be changed using the menu item (if reqtools.library is available), a requester is displayed allowing the input of the value. TSMorph.guide/P-DY DY=number --------- This parameter can be used to speed up the rendering process. The default value is 0. If set to a number then only some Vertical pixels will be generated. e.g. if set to 1 then only every other line will be generated. The others will be copied from the previous line. This can be overridden by using ARexx. Also see DX. It can be changed using the menu item (if reqtools.library is available), a requester is displayed allowing the input of the value. TSMorph.guide/P-EGS-R EGS=YES/NO ---------- By default TSMorph-render does not show its output when rendering. If this parameter is set to YES then output will be displayed in an EGS window on the default EGS screen a line at a time. See requirements for library requirements. This parameter is not available as a menu option, is not saved in settings files and can not be specified on a project Icon. Default values is NO. TSMorph.guide/P-FILES-R FILES=filename -------------- This is only relevant to the Shell, only one name can be supplied - default is to show an ASL file requester for the file to run. TSMorph.guide/P-INTEGER INTEGER=NO/YES -------------- This parameter and menu item select if the render process should use integer or floating point arithmetic. The process will be faster if integer arithmetic is used (especially on machines without an FPU). However the output quality will not be so good. If this parameter is set to YES then the ANTIALIAS parameter is ignored. Default value is NO. TSMorph.guide/P-LOADSCRIPT LOADSCRIPT=Scriptname/OFF ------------------------- This specifies the name of an ARexx script to run before each image 24 bit image is loaded. This can be used to e.g. hold the images on disc in JPEG format to save space and convert each image back to 24 bit ILBM when required. Note however that TSMorph-render now has the ability to load a large variety of image formats (All ILBM including HAM6, HAM8, EHB, and DCTV with dctv.library, JPEG, TARGA, PPM, and GIF). The default script is Rexx/Loadscript. The version supplied does nothing. Set to OFF to run no script. It can be changed using the menu item (if reqtools.library is available), a requester is displayed allowing the input of the value. TSMorph.guide/P-MODE MODE=0-31 --------- This parameter and menu item indicate how the Morphing algorithm should search to find the points to use for morphing. The values are additive: 1 : Leaves un-triangled point stationary 2 : Searches all the closest points 4 : Uses a squaring algorithm to find close points 8 : Uses a Delaunay algorithm to find triangles 16: Precalculate close points Default value is 0. TSMorph.guide/P-POSTSCRIPT POSTSCRIPT=Scriptname/OFF ------------------------- This specifies the name of an ARexx script to run after each image is rendered. This can be used to build an animation or change the image format from 24 bit. The default script is Rexx/Postscript. The version supplied does nothing. Set to OFF to run no script. It can be changed using the menu item (if reqtools.library is available), a requester is displayed allowing the input of the value. TSMorph.guide/P-PRESCRIPT PRESCRIPT=Scriptname/OFF ------------------------ This specifies the name of an ARexx script to run before each image is rendered. This can be used to produce only some of the frames and control the movement and colour of the images. The default script is Rexx/Prescript. The version supplied does nothing. Set to OFF to run no script. It can be changed using the menu item (if reqtools.library is available), a requester is displayed allowing the input of the value. TSMorph.guide/P-PUBSCREENR PUBSCREENR=pubscreenname ------------------------ This gives the name of the Public Screen on which to open TSMorph-render windows - default is the default public screen. It can be changed using the menu item (if reqtools.library is available), a requester is displayed allowing the input of the screen name. TSMorph.guide/P-QUALITY QUALITY=number -------------- This specifies the quality of output files. This option only applies if opal.library is available and SAVEFORMAT is JPEG or JPEGT. Possible values are 0 to 100. Default value is 75. It can be changed using the menu item (if reqtools.library is available), a requester is displayed allowing the input of the value. TSMorph.guide/P-REQTOOLS-R REQTOOLS=YES/NO/ALL ------------------- This controls the use of reqtools.library. If set to NO then reqtools will not be used (except in very unusual circumstances). It will still however be opened and closed. If set to YES then reqtools will be used for various requesters. If set to ALL then it will be used for the File Requesters as well. This parameter is not available as a menu option, is not saved in settings files and can not be specified on a project Icon. Default values is YES. TSMorph.guide/P-SAVEFORMAT SAVEFORMAT=ILBM24/OPAL24/OPAL24T/OPAL24F/OPAL24FT/JPEG/JPEGT/PPM/BW16/BW256/HAM6/HAM8/DCTV3/DCTV4 ------------------------------------------------------------------------------------------------- This parameter and menu item specify the format TSMorph-render should use to save the output images. OPAL and JPEG formats are only available if opal.library is available. DCTV3 and DCTV4 formats are only available if dctv.library is available. ILBM24 - IFF 24 bit ILBM with no CAMG chunk OPAL24 - IFF 24 bit ILBM saved using opal.library OPAL24T - as OPAL24 with a Thumbnail OPAL24F - as OPAL24 in Fast Format OPAL24TF - as OPAL24F with a Thumbnail JPEG - JPEG format using opal.library JPEGT - as JPEG with a Thumbnail PPM - PPM format BW16 - ILBM 16 colour grey scale BW256 - ILBM 256 colour grey scale HAM6 - ILBM 6 plane HAM HAM8 - ILBM 8 plane HAM DCTV3 - ILBM 3 plane DCTV using dctv.library DCTV4 - ILBM 4 plane DCTV using dctv.library The quality of JPEG images can be set using the QUALITY parameter. PPM format is basically uncompressed 24 bit. The files are therefore very large and it is suggested that a compressing file handler (such as XFH or EPU) is used. This format is provided mainly to allow the easy production of MPEG movies. The save format also controls which Icon is saved with the image. TSMorph.guide/P-SETTINGS-R SETTINGS=filename ----------------- This can only be supplied on the Shell command line, or an Icon Tool Type. This specifies the name of a file to contain settings. See parameters. TSMorph.guide/P-TOOLPRI TOOLPRI=number -------------- This can only be supplied as a Tool Icon tool type. It sets the priority of the rendering process. Setting to -1 is a good idea if you wish to run the program in the background. The default value is 0. Setting to positive values is generally not a good idea. TSMorph.guide/Info The Information Window ********************** This window is always displayed when TSMorph is running. It displays information about the current project. The window title is TSMorph, the screen title will be displayed as the project name if the project has a name. It is used to set up all the information required by TSMorph-render. Gadgets Gadgets displayed in the Info Window Menus Menus available in the Info Window Keyboard Keyboard controls in the Info Window TSMorph.guide/I-gad Gadgets in Info Window ====================== The Information Window appears with gadgets: ---------------------------- |. |TSMorph | | | |--------------------------| | Help Text | | File One ............. X | | File Two ............. X | |24 File 1 ............. X | |24 File 2 ............. X | | Width ... Height ... | | Single Frames.. Start .. | | Name ............ X | | Edit Points... | ---------------------------- Help Text Displays help messages (release 3.0+) File One The first image file for point editing Get file Get file gadget for above File Two The second image file for point editing Get File Get file gadget for above 24 File 1 The first 24 bit image file to morph Get File Get file gadget for above 24 File 2 The second 24 bit image file to morph Get File Get file gadget for above Width Read only gadget showing width Height Read only gadget showing Height Single Cycle morph mode gadget Frames Number of frames to generate Start Frame number to start at Name File name of animation frames Get File Get file gadget for above Edit Points... Display images to edit points Close gadget Quit program Zoom gadget Standard zoom window Depth gadget Standard depth gadget TSMorph.guide/I-gad-Help Help Text gadget ---------------- This gadget displays short help messages. From release 3.0 and up it displays more information. See also Continuous Help. TSMorph.guide/I-gad-File_One File One gadget --------------- This gadget allows the editing of the file name of the first image to be used when editing points. This gadget is disabled if the Edit Windows are currently open. The file name can be either edited in the string gadget or by using the Get File to display an ASL file requester. This image should be a Workbench displayable version of the first 24 bit file. (See OPENMODE for what images can be loaded.) It is displayed in the first Edit Window when editing points. o can be used to activate this gadget - See Keyboard. See File naming for how to specify the file name. TSMorph.guide/I-gad-Get_File_One Get File One gadget ------------------- This gadget displays an ASL file requester to select the file to appear in the File One gadget. o with shift is the same as using this gadget - See Keyboard. TSMorph.guide/I-gad-File_Two File Two gadget --------------- This gadget is the same as the File One gadget for the second displayable image. This image should be the same size as the first. t can be used to activate this gadget - See Keyboard. See File naming for how to specify the file name. TSMorph.guide/I-gad-Get_File_Two Get File Two gadget ------------------- This gadget displays an ASL file requester to select the file to appear in the File Two gadget. t with shift is the same as using this gadget - See Keyboard. TSMorph.guide/I-gad-24_File_1 24 File 1 gadget ---------------- This gadget allows the editing of the file name of the first image to be used when morphing. The file name can be either edited in the string gadget or by using the Get File to display an ASL file requester. This image should be a 24 bit version of the first displayable file. Also see the LOADSCRIPT parameter. Note: TSMorph now has the ability to load a large variety of images as 24 bit files. If this gadget is left blank then the name from the first displayable file is used. 1 can be used to activate this gadget - See Keyboard. See File naming for how to specify the file name. TSMorph.guide/I-gad-Get_24_File_1 Get 24 File 1 gadget -------------------- This gadget displays an ASL file requester to select the file to appear in the 24 File 1 gadget. 1 with shift is the same as using this gadget - See Keyboard. TSMorph.guide/I-gad-24_File_2 24 File 2 gadget ---------------- This gadget allows the editing of the file name of the last image to be used when morphing. The file name can be either edited in the string gadget or by using the Get File to display an ASL file requester. This image should be a 24 bit version of the second displayable file. Also see the LOADSCRIPT parameter. Note: TSMorph now has the ability to load a large variety of images as 24 bit files. If this gadget is left blank then the name from the second displayable file is used. If Single Image mode is selected then this is ignored. 2 can be used to activate this gadget - See Keyboard. See File naming for how to specify the file name. TSMorph.guide/I-gad-Get_24_File_2 Get 24 File 2 gadget -------------------- This gadget displays an ASL file requester to select the file to appear in the 24 File 2 gadget. 2 with shift is the same as using this gadget - See Keyboard. TSMorph.guide/I-gad-Width Width gadget ------------ This gadget displays the width of the images being edited. If images have not been selected then it should display the maximum width of the current points. TSMorph.guide/I-gad-Height Height gadget ------------- This gadget displays the height of the images being edited. If images have not been selected then it should display the maximum height of the current points. TSMorph.guide/I-gad-Single Single image gadget ------------------- This gadget cycles between Morphs, Warps, Animated Morphs and Animated Warps. In Warp mode one image is distorted based on the control points. In Morph mode one image is distorted/recoloured into a second image based on control points. In animated Warps and Morphs the input images can change on each output frame. r and R can be used to cycle this gadget forward and backward - See Keyboard. Note: Animated Warps/Morphs are only available if Reqtools is available. TSMorph.guide/I-gad-Frames Number of Frames gadget ----------------------- This gadget can be used to specify the number of frames to generate. In Single mode the total number of frames will be this number plus the first image. In dual mode the total number of frames is the first image, this number and the last image. f can be used to activate this gadget - See Keyboard. This gadget is disabled if Images are displayed and an animated Morph/Warp is being edited. TSMorph.guide/I-gad-Start Start Frame gadget ------------------ This gadget can be used to specify the number to use in the Name of the first generated file. This number is then incremented by 1 for each subsequent frame. a can be used to activate this gadget - See Keyboard. This gadget is disabled if Images are displayed and an animated Morph/Warp is being edited. TSMorph.guide/I-gad-Name Anim file Name gadget --------------------- This gadget is used to name the files produced by TSMorph-render. The file name can be either edited in the string gadget or by using the Get File to display an ASL file requester. The file name should contain the characters %ld. These characters will be replaced by the frame number, starting from that specified in the Start gadget. n can be used to activate this gadget - See Keyboard. See File naming for further information on how to specify the file name. TSMorph.guide/I-gad-Get_Name Get Anim file Name gadget ------------------------- This gadget displays an ASL file requester to select the file to appear in the Name gadget. n with shift is the same as using this gadget - See Keyboard. TSMorph.guide/I-gad-Edit_Points Edit Points... gadget --------------------- This button gadget has the same effect as the Edit Points menu option. It opens the Control Window and Edit Windows to allow editing of the control points. If these windows are already open then the Control Window is activated. p is the same as using this gadget - See Keyboard. TSMorph.guide/I-gad-Close Close gadget ------------ This is a standard close gadget. Clicking quits the program. If the current project has been changed but not saved then the Unsaved Project requester is displayed. TSMorph.guide/I-gad-Zoom Zoom gadget ----------- This is a standard Zoom gadget which switches the window between full size and a title bar and the help text. TSMorph.guide/I-gad-Depth Depth gadget ------------ This is a standard depth gadget. TSMorph.guide/I-men Menus on the Info Window ======================== The following menus are available on the Information Window: Project Project menu Settings Settings menu TSMorph.guide/I-men-P Info Window Project menu ------------------------ This menu contains the following items with their associated Amiga short-cuts in the Info Window: New N Create a new project Open... O Open a file Save S Save file Save As... Save named file Delete... Delete a Project About... Show about requester Quit Q Quit program Preview... Preview render Edit Points E Open windows to edit points TSMorph.guide/I-men-P-New Info Window Project/New menu item ................................. This menu item creates a new project. If the current project has been changed but not saved then the Unsaved Project requester is displayed. TSMorph.guide/I-men-P-Open Info Window Project/Open menu item .................................. This menu item allows the loading of a previously created Parameter file. If the current project has been changed but not saved then the Unsaved Project requester is displayed. TSMorph.guide/I-men-P-Save Info Window Project/Save menu item .................................. This saves the current project using the current name. If the project does not yet have a name then an ASL file requester is displayed. See File Format. TSMorph.guide/I-men-P-Save_As Info Window Project/Save As... menu item ........................................ This saves the current project using a name chosen suing an ASL file requester. See File Format. TSMorph.guide/I-men-P-Delete Info Window Project/Delete... menu item ....................................... This can be used to delete a Project. It will delete the main file, its icon (if present) and any associated Anim points files. See File Format. TSMorph.guide/I-men-P-About Info Window Project/About... menu item ...................................... This displays some program version information in the About Requester. TSMorph.guide/I-men-P-Quit Info Window Project/Quit menu item .................................. This quits TSMorph. If the current project has been changed but not saved then the Unsaved Project requester is displayed. TSMorph.guide/I-men-P-Preview Info Window Project/Preview... menu item ........................................ This menu item renders the image using the ARexx script supplied in the PREVIEW parameter. If required it first displays the Frame Number requester. This menu option is only available if reqtools.library is available. If the current project has been changed but not saved then the Unsaved Project requester is displayed. TSMorph.guide/I-men-P-Edit_Points Info Window Project/Edit Points menu item ......................................... This is the same as the Edit Points gadget. It opens the Control Window and Edit Windows to allow editing of the control points. If these windows are already open then the Control Window is activated. TSMorph.guide/I-Key Keyboard controls in the Info Window ==================================== The following keyboard controls are available in the Info Window: o Activate File One gadget With shift - show file requester - See Get File One. t Activate File Two gadget With shift - show file requester - See Get File Two. 1 Activate 24 File 1 gadget With shift - show file requester - See Get 24 File 1. 2 Activate 24 File 2 gadget With shift - show file requester - See Get 24 File 2. rR Cycle Single image gadget. f Activate Frames gadget. a Activate Start gadget. n Activate Name gadget With shift - show file requester - See Get Name. p Same as Edit Points gadget Help displays context sensitive help using amigaguide if available. TSMorph.guide/Con The Control Window ****************** The control window displays various gadgets for different for different point editing modes. The title bar displays the current editing mode as does the Mouse pointer. The screen title bar displays TSMorph for non-animated Warps/Morphs and TSMorph - Frame nnn for animated Warps/Morphs. Gadgets Gadgets displayed in the control window Menus Menus on the Control Window Edit Modes Point editing modes Keyboard Keyboard controls in the Control Window TSMorph.guide/Con-gad Control and Image Window gadgets ================================ The Control Window appears with gadgets: -------------- |. | Mov | | |------------| | ONE TWO | | REL ADD | | DEL LNK | | UNL MOV | ||< <- ? -> >| | -------------- Most are used to set the edit mode. The rest except the close and depth gadgets are used to set the current Frame Number. One Move points in one window Two Move points in both windows Rel Move points relatively in both windows Add Add a new point Del Delete an existing point Lnk Link two points Unl Unlink two points Mov Scroll the window |< First Frame < Previous Frame ? Goto Frame > Next Frame >| Last Frame Close Close window Depth Depth gadget TSMorph.guide/Con-gad-First Control Window First Frame gadget --------------------------------- This gadget goes to the first frame. This is the same as the First menu item. This gadget is disabled if the Morph/Warp is not animated, or the first frame is already displayed. TSMorph.guide/Con-gad-Previous Control Window Previous Frame gadget ------------------------------------ This gadget goes to the previous frame. This is the same as the Previous menu item. This gadget is disabled if the Morph/Warp is not animated, or the first frame is currently displayed. TSMorph.guide/Con-gad-Goto Control Window Goto Frame gadget -------------------------------- This gadget goes to a chosen frame. This is the same as the Goto menu item. It displays the Frame Number Requester. This gadget is disabled if the Morph/Warp is not animated. TSMorph.guide/Con-gad-Next Control Window Next Frame gadget -------------------------------- This gadget goes to the next frame. This is the same as the Next menu item. This gadget is disabled if the Morph/Warp is not animated, or the last frame is currently displayed. TSMorph.guide/Con-gad-Last Control Window Last Frame gadget -------------------------------- This gadget goes to the last frame. This is the same as the Last menu item. This gadget is disabled if the Morph/Warp is not animated, or the last frame is already displayed. TSMorph.guide/Con-gad-Close Control Window Close gadget --------------------------- This closes the Control Window , and the Edit Windows. TSMorph.guide/Con-gad-Depth Control Window Depth gadget --------------------------- This is a standard depth gadget. TSMorph.guide/CI-men Control and Edit Windows menus ============================== The following menus are available on the Control and Edit Windows: Project Project menu Edit Edit menu Settings Settings menu TSMorph.guide/CI-men-P Control and Edit Windows Project menu ------------------------------------- This menu contains the following items with their associated Amiga short-cuts in the Control and Edit Windows: New Points N Delete all points Open Points... O Read points from a file Save S Save file Save As... A Save named file About... Show about requester Exit Points Open windows to edit points Quit Q Quit program Preview... Preview render TSMorph.guide/CI-men-P-New Control and Edit Window Project/New Points menu item .................................................... This menu item deletes all existing points. TSMorph.guide/CI-men-P-Open Control and Edit Window Project/Open Points menu item ..................................................... This menu item allows the loading of a previously created Parameter file. Only the points are loaded from the file. Other parameters are retained. If the current project has been changed but not saved then the Unsaved Project requester is displayed. TSMorph.guide/CI-men-P-Save Control and Edit Window Project/Save menu item .............................................. This saves the current project using the current name. If the project does not yet have a name then an ASL file requester is displayed. See File Format. TSMorph.guide/CI-men-P-Save_As Control and Edit Window Project/Save As... menu item .................................................... This saves the current project using a name chosen using an ASL file requester. See File Format. TSMorph.guide/CI-men-P-About Control and Edit Window Project/About... menu item .................................................. This displays some program version information in the About Requester. TSMorph.guide/CI-men-P-Exit_Points Control and Edit Window Project/Exit Points menu item ..................................................... This is the same as closing the Control Window or either of the Edit Windows. It closes all of these windows. TSMorph.guide/CI-men-P-Quit Control and Edit Window Project/Quit menu item .............................................. This quits TSMorph. If the current project has been changed but not saved then the Unsaved Project requester is displayed. TSMorph.guide/CI-men-P-Preview Control and Edit Windows Project/Preview... menu item ..................................................... This menu item renders the image using the ARexx script supplied in the PREVIEW parameter. If required it first displays the Frame Number requester. This menu option is only available if reqtools.library is available. If the current project has been changed but not saved then the Unsaved Project requester is displayed. TSMorph.guide/CI-men-E Control and Edit Window Edit menu --------------------------------- This menu contains the following items with their associated Amiga short-cuts in the Control and Edit Windows: Add Grid... G Add a grid of points Triangulate T Convert links to triangles Frame » Change the Frame Number Mode » Set the edit mode. TSMorph.guide/CI-men-E-Grid Control and Edit Window Edit/Add Grid... menu item .................................................. This menu item displays the Add Grid requester to add a grid of points to the images. TSMorph.guide/CI-men-E-Triangulate Control and Edit Window Edit/Triangulate menu item .................................................. This menu item deletes all links between points and attempts to convert them to triangles (similar to the MODE=24 option of TSMorph-render). If the current project has been changed then the Unsaved Project requester is displayed. TSMorph.guide/CI-men-E-Frame Control and Edit Windows Frame sub menu ....................................... This sub menu contains the following items with their associated Amiga short-cuts in the Control and Edit Windows: First < First Frame Previous - Previous Frame Goto... . Goto Frame Next + Next Frame Last > Last Frame TSMorph.guide/CI-men-E-Frame-First Control and Edit Windows Frame/First menu item ********************************************** This menu item goes to the first frame. This is the same as the First gadget. This menu item is disabled if the Morph/Warp is not animated, or the first frame is already displayed. TSMorph.guide/CI-men-E-Frame-Previous Control and Edit Windows Frame/Previous menu item ************************************************* This menu item goes to the previous frame. This is the same as the Previous gadget. This menu item is disabled if the Morph/Warp is not animated, or the first frame is already displayed. TSMorph.guide/CI-men-E-Frame-Goto Control and Edit Windows Frame/Goto menu item ********************************************* This menu item goes to a chosen frame. This is the same as the Goto gadget. It displays the Frame Number Requester. This menu item is disabled if the Morph/Warp is not animated, or the first frame is already displayed. TSMorph.guide/CI-men-E-Frame-Next Control and Edit Windows Frame/Next menu item ********************************************* This menu item goes to the next frame. This is the same as the Next gadget. This menu item is disabled if the Morph/Warp is not animated, or the last frame is already displayed. TSMorph.guide/CI-men-E-Frame-Last Control and Edit Windows Frame/Last menu item ********************************************* This menu item goes to the last frame. This is the same as the Last gadget. This menu item is disabled if the Morph/Warp is not animated, or the last frame is already displayed. TSMorph.guide/CI-men-E-EMode Control and Edit Window Edit/Mode sub menu .......................................... This sub menu contains the following items with their associated Amiga short-cuts in the Control and Edit Windows: Edit One 1 Move points in one window Edit Two 2 Move points in both windows Edit Rel 3 Move points relatively in both windows Add 4 Add a new point Delete 5 Delete an existing point Link 6 Link two points Unlink 7 Unlink two points None 8 Scroll the window TSMorph.guide/men-Settings Settings menu ------------- This menu contains the following items with their associated Amiga short-cuts in the Control , Info and Edit Windows. Settings can be set using Parameters. All menu items which display requesters will not be available if reqtools.library is not available. Items requiring opal.library will not be available if opal.library is not available. Create Icons? Create Icons on projects? Change Palette? P Use Image palette? Zoom? Z Zoom Image? Open Mode » How to open images Public Screen... Screen for TSMorph Custom Mode... Mode of Custom screen to open Custom Depth... Depth of Custom screen to open Preview Script... ARexx preview script Create Prefs Icons? Create Icons on settings Keep Settings? Keep settings on Quit Load Settings... Display file requester to load settings Save Settings Save settings in ENVARC:TSMorph/TSMorph.prefs Save Settings As... Display file requester to save settings Create Render Icons? Create Icons on images? DX... Horizontal skip DY... Vertical skip Load Script... ARexx load script Pre Script... ARexx pre frame script Post Script... ARexx post frame script Depth Morphing algorithm depth Mode » Morphing algorithm mode Save Format » Image save format JPEG Quality Quality of JPEG images Render Screen... Public screen for TSMorph-render Anti-Alias? Anti-Alias the output images Integer? Use integer maths Reset To Defaults Reset to default settings Last Saved Restore from ENVARC:TSMorph/TSMorph.prefs Restore Restore from ENV:TSMorph/TSMorph.prefs Continuous Help? Display continuous help TSMorph.guide/men-S-LoadS Setting/Load Settings... menu item .................................. This displays an ASL requester to load settings into the currently running program. The default name is TSMorph.prefs. TSMorph.guide/men-S-SaveS Settings/Save Settings menu item ................................ This saves the current settings in ENVARC:TSMorph/TSMorph.prefs and ENV:TSMorph/TSMorph.prefs. If CREATEICONSP is set then an Icon is saved as well Unless KEEPSETTINGS is set to NO current settings are saved in ENV:TSMorph/TSMorph.prefs whenever TSMorph is quit. TSMorph.guide/men-S-SaveSAs Setting/Save Settings As... menu item ..................................... This displays an ASL requester to save the current settings. If CREATEICONSP is set then an Icon is saved as well The default name is TSMorph.prefs. TSMorph.guide/men-S-ResetD Setting/Reset To Defaults menu item ................................... This resets settings to there default values. If some Image windows are open and CHANGEPALETTE is set to OFF then it will stay OFF. The same applies to ZOOM. TSMorph.guide/men-S-LastS Settings/Last Saved menu item ............................. This reset settings to the values last saved in ENVARC:TSMorph/TSMorph.prefs (overridden by any Tool Types). If some Image windows are open and CHANGEPALETTE is set to OFF then it will stay OFF. The same applies to ZOOM. TSMorph.guide/men-S-Restore Setting/Restore menu item ......................... This resets settings to the values last saved in ENV:TSMorph/TSMorph.prefs (overridden by any Tool Types). Settings are saved in this file whenever TSMorph is quit if KEEPSETTINGS is set to YES. If some Image windows are open and CHANGEPALETTE is set to OFF then it will stay OFF. The same applies to ZOOM. TSMorph.guide/Con-Key Keyboard controls in the Control Window ======================================= Help displays context sensitive help using amigaguide if available. TSMorph.guide/Edit The Edit Windows **************** The Edit windows display Workbench displayable versions of the images to be morphed along with the control points. The window title displays the file name, the screen title displays the full file name. The mouse pointer shows the current editing mode. The windows are sizeable and have scrollbars. The menus displayed are the same as the Control Window. The first click in these windows is ignored. If EGS is being used then the windows are displayed on the EGS screen without menus. Keyboard short cuts 1-8 are still available. The windows do not, however, automatically scroll. Gadgets Gadgets on the Edit Windows Menus Menus on the Edit Windows Keyboard Keyboard controls on the Edit Windows Modes Point editing modes. TSMorph.guide/E-gad Gadgets on the Edit Windows =========================== The Edit Windows appears with gadgets: ------------------ |. |filename | | |----------------| | | | | ||| | | ||| | | ||| | | ||| | | |/| | | |\| | |----------------| |------- <- -> |// | ------------------ Horizontal scroll gadget Scrolls image horizontally Vertical scroll gadget Scrolls image vertically Up gadget Scroll image up Down gadget Scroll image down Left gadget Scroll image left Right gadget Scroll image right Close gadget Close Edit and Control Windows Zoom gadget Zoom window Depth gadget Depth gadget Sizing gadget Sizing gadget TSMorph.guide/E-gad-Horiz Edit Windows Horizontal gadget ------------------------------ This gadget can be used to scroll the image horizontally. TSMorph.guide/E-gad-Vert Edit Windows Vertical gadget ---------------------------- This gadget can be used to scroll the image vertically. TSMorph.guide/E-gad-Up Edit Windows Up gadget ---------------------- This gadget can be used to scroll the image up. Holding down shift will cause the window to scroll one pixel at a time. TSMorph.guide/E-gad-Down Edit Windows Down gadget ------------------------ This gadget can be used to scroll the image down. Holding down shift will cause the window to scroll one pixel at a time. TSMorph.guide/E-gad-Left Edit Windows Left gadget ------------------------ This gadget can be used to scroll the image left. Holding down shift will cause the window to scroll one pixel at a time. TSMorph.guide/E-gad-Right Edit Windows Right gadget ------------------------- This gadget can be used to scroll the image right. Holding down shift will cause the window to scroll one pixel at a time. TSMorph.guide/E-gad-Close Edit Windows Close gadget ------------------------- This closes the Control Window , and the Edit Windows. TSMorph.guide/E-gad-Zoom Edit Windows Zoom gadget ------------------------ This is a standard Zoom gadget. It swaps the size between maximum and minimum Maximum is the smaller of the size of the image or the size of the screen. Minimum is the minimum required for all gadgets to still be visible. TSMorph.guide/E-gad-Depth Edit Windows Depth gadget ------------------------- This is a standard depth gadget. TSMorph.guide/E-gad-Size Edit Windows Sizing gadget -------------------------- This a standard sizing gadget. See Zoom gadget for the sizing limits TSMorph.guide/E-Key Keyboard controls in the Edit Windows ===================================== The number keys can be used to set the Edit Mode. 1 Move points in one window 2 Move points in both windows 3 Move points relatively in both windows 4 Add a new point 5 Delete an existing point 6 Link two points 7 Unlink two points 8 Scroll the window Help displays context sensitive help using amigaguide if available. TSMorph.guide/EModes Point editing modes ******************* The following edit modes are available to edit points: One Move points in one window Two Move points in both windows Relative Move points relatively in both windows Add Add a new point Delete Delete an existing point Link Link two points Unlink Unlink two points Move Scroll the window Note: The menu button can always be used to abort the current operation before releasing the select button. Modes can be set using gadgets in the Control Window or by using menus on the Control and Edit Windows. TSMorph.guide/EMode-One Edit Mode One ============= This mode is used to move a point in one of the Edit Windows. The Control Windows title is set to One. The Mouse Pointer is set to ONE. Points can be clicked and moved in either of the windows with the mouse - the point will only move in the selected window. TSMorph.guide/EMode-Two Edit Mode Two ============= This mode is used to move a point in both of the Edit Windows. The Control Windows title is set to Two. The Mouse Pointer is set to TWO. Points can be clicked and moved in both of the windows with the mouse - the point will move in both windows to the same absolute position. TSMorph.guide/EMode-Relative Edit Mode Relative ================== This mode is used to move a point in both of the Edit Windows. The Control Windows title is set to Rel. The Mouse Pointer is set to REL. Points can be clicked and moved in both of the windows with the mouse - the point will move in both windows to the same relative position. TSMorph.guide/EMode-Add Edit Mode Add ============= This mode is used to add a point in both of the Edit Windows. The Control Windows title is set to Add. The Mouse Pointer is set to ADD. Points can be added in either of the windows by clicking the mouse - the point will added to both windows to the same absolute position. TSMorph.guide/EMode-Delete Edit Mode Delete ================ This mode is used to delete a point in both of the Edit Windows. The Control Windows title is set to Del. The Mouse Pointer is set to DEL. Points can be deleted in either of the windows by clicking the mouse - the point will deleted from both windows. Any links will also be removed. TSMorph.guide/EMode-Link Edit Mode Link ============== This mode is used to link two points in both of the Edit Windows. The Control Windows title is initially set to L1. The Mouse Pointer is set to L1. A point can then be selected in either of the windows by clicking the mouse. The Control Windows title is then set to L2. The Mouse Pointer is set to L2. Another point can then be selected in either of the windows by clicking the mouse. The points will be joined by a line. Note: this line is to enable points to be identified more easily. It is not used by the rendering process. TSMorph.guide/EMode-Unlink Edit Mode Unlink ================ This mode is used to unlink two linked points in both of the Edit Windows. The Control Windows title is initially set to U1. The Mouse Pointer is set to U1. A point can then be selected in either of the windows by clicking the mouse. The Control Windows title is then set to U2. The Mouse Pointer is set to U2. Another point can then be selected in either of the windows by clicking the mouse. If the points are currently joined then the line will be removed. TSMorph.guide/EMode-Move Edit Mode Move ============== In this mode no points are edited. The Control Windows title is set to Mov. The Mouse Pointer is set to Mov. Clicking in the window and moving the mouse will scroll the window. This is the initial mode when the Edit Windows are opened. If EGS is being used then the windows will not scroll. TSMorph.guide/Req Requesters which appear *********************** The following requesters are produced: Unsaved Project Quitting having not saved About requester Version Information Error requester Error messages Add Grid Add a grid of points Frame Number? Choose a Frame Number Progress Progress Really quit? Really quit? TSMorph.guide/Req-Unsaved Unsaved project requester ========================= This requester is displayed when attempting to quit, preview render or triangulate without having saved a project. It displays 3 or 4 options (depending on if amigaguide is available): Save: Save the project and quit, render or triangulate Help: Display help (only shown if available) Abandon: Quit, preview or triangulate without saving the project Cancel: Do not save and do not quit, preview or triangulate If reqtools.library(38) is available then this will be used and keyboard short-cuts (the first character of the option) will be available and underlined. TSMorph.guide/Req-About About requester =============== This requester is displayed when About... is chosen on a menu on the Info Window or Control or Edit Windows. It displays version information. If reqtools.library(38) is available then this will be used and keyboard short-cuts (the first character of the option) will be available and underlined. TSMorph.guide/Req-Error Error requesters ================ This requester is displayed if an error occurs. It displays an error message and gives one (or two) options. If amigaguide is available then the first option will be Help - this will display detailed information on the error message. The last option is Quit for fatal errors, and OK for non fatal errors. See Errors for details on error messages. If reqtools.library(38) is available then this will be used and keyboard short-cuts (the first character of the option) will be available and underlined. If EGS is being used and the edit windows are open then the requester will appear on the EGS screen. TSMorph.guide/Req-Add_Grid Add Grid requester ================== The Add Grid requester appears as below when the Add Grid... menu item is chosen --------------- |. |Add Grid| | |-------------| | X Cells ... | | Y Cells ... | | | | OK Cancel | --------------- The following gadgets are displayed in the requester with their associated keyboard equivalents: X Cells X Set number of X cells Y Cells Y Set number of Y Cells OK O Add points Cancel C Cancel requester Close Close gadget Depth Depth gadget TSMorph.guide/Req-Add_Grid-gad-X_Cells Add Grid X Cells gadget ----------------------- This gadget is used to input the number of horizontal cells of points to add. The minimum number is 1. The default value displayed is 5. This gadget can be activated by using the X key. TSMorph.guide/Req-Add_Grid-gad-Y_Cells Add Grid Y Cells gadget ----------------------- This gadget is used to input the number of vertical cells of points to add. The minimum number is 1. The default value displayed is 5. This gadget can be activated by using the Y key. TSMorph.guide/Req-Add_Grid-gad-OK Add Grid OK gadget ------------------ Selecting this gadget adds points of cells to the images. The number of horizontal cells can be set in the X Cells gadget and the number of vertical cells in the Y Cells gadget. The O key is the same as using this gadget. TSMorph.guide/Req-Add_Grid-gad-Cancel Add Grid Cancel gadget ---------------------- This gadget cancels the Add Grid requester without adding any points. The C key is the same as using this gadget. TSMorph.guide/Req-Add_Grid-gad-Close Add Grid Close gadget --------------------- This is the same as the Cancel gadget and cancels the requester. TSMorph.guide/Req-Add_Grid-gad-Depth Add Grid Depth gadget --------------------- This is a standard depth gadget. TSMorph.guide/Req-FrameNumber Choose a Frame Number requester =============================== This requester is displayed when the Edit Points gadget is selected (and there is more than one frame) on an animated Morph/Warp, or the Goto gadget or Goto menu item is selected, or the Preview... or Preview... menu item is selected. It displays the first and last frame number and allows input of the required frame number. It displays OK, Help (if amigaguide is available) and Cancel gadgets. The keyboard shortcuts (O,H and C) are underlined. TSMorph.guide/Req-Progress Progress requester ================== This requester is displayed by TSMorph-render. It shows a list view of information messages, and the current frame and line being calculated. It also displays a stop button and a zoom and depth gadget. The stop gadget is checked every line. Clicking it displays the Really quit? requester allowing the program to be stopped. The Help key displays help. TSMorph.guide/Req-Really_quit Really quit? requester ====================== This requester is displayed when the stop gadget is clicked on the Progress requester. It displays two (or three) options Quit (Help) and Continue. Quit quits the program, Continue restarts the calculation, Help is displayed if amigaguide is available and displays help. If reqtools.library(38) is available then this will be used and keyboard short-cuts (the first character of the option) will be available and underlined. TSMorph.guide/Interface Changing the Interface ********************** All the gadgets in the Control window, and the mouse pointers can be edited. The brushes are stored in the directory Brush/. All may be edited and using e.g. DPaint. The following brushes are size 38x34: add del link none one rel two unlink The following are 15x15: 1st Last Next Prev The following is 16x15: Goto The mouse pointers are stored in the directory Cursor/. All may be edited using the Workbench Pointer editor. The following Pointers can be edited: Xadd Xdel Xl1 Xl2 Xmov Xone Xrel Xtwo Xu1 Xu2 TSMorph.guide/File_Format Internal file formats ********************* The file format is subject to change at any time. The current format for the main file is: TSMorph 1.2 file_name_one file_name_two 24_bit_file_name_1 24_bit_file_name_2 anim_file_name w=a,h=b,Frames=c,Single=d,Start=e x=n,y=m,x1=o,y1=p . . . p1=i,p2=j . . . where TSMorph 1.2 is a header record (not present in the previous version of TSMorph, old formats can still be loaded producing a warning message ), a is the width, b the height, c the number of frames, d is 0 for Morph, 1 for Warp, 2 for Anim Morph and 3 for Anim Warp, e is the start frame number, n,m are coordinates on the first image, o,p on the second image, and i and j are the number of the points to join (starting from 0). For animated Warps and Morphs the main file contains no points. Each frame has a set of points held in a file named with .nnn after the main file name, where nnn is the frame number. This file has a header of TSMorph 2.0 and then has the Points details. TSMorph.guide/AR ARexx interface to TSMorph-render and TSMorph ********************************************* ARexx scripts are run before and after each image is rendered, and before each 24 bit image is loaded. The script names can be supplied as parameters (LOADSCRIPT , PRESCRIPT and POSTSCRIPT ) to TSMorph-render. An ARexx script can also be run by TSMorph to preview render an image. The script name is supplied in the PREVIEW parameter. The suffix to each ARexx script should be .TSM. Loadscript Run before loading 24 bit image Prescript Run before rendering Postscript Run after rendering Preview Preview render an image TSMorph.guide/AR-Loadscript ARexx script run before loading 24 bit image ============================================ This script is run before each 24 bit ILBM image is loaded. It is passed the following parameters: Frame : The current frame number, starting at Start. TotalFrames : The total number of frames being rendered. Single : Set to 1 if a Warp, 0 for a Morph, 2 for Anim Morph, 3 for Anim Warp. Image : Set to 0 for 1st image, 1 for second. FileName : Name of file just rendered. This script can be used to change the format of the input file (by running it through a conversion program). One example is included: Loadscript.TSM - Do nothing example TSMorph.guide/AR-Prescript ARexx script run before rendering ================================= This script is run before each image is rendered. It is also called for the first image (for warps and morphs) and for the last image (for morphs). By default the first and last frames are not rendered. Produce will need to be set to 1 to output these frames. This allows the first and last frames to be converted to the same format as the other output images. It is passed one parameter - Base - the address of a structure which contains the following: Frame = 0 : The current frame number, starting at 1 (0 for 1st frame) - read only. TotalFrames = 1 : The total number of frames being rendered - read only. Single = 2 : Set to 1 if a Warp, 0 = Morph, 2 = Anim Morph, 3 = Anim Warp - read only. Movement = 3 : 0 to 1024 - the proportion of movement from first to second image. Red1 = 4 : 0 to 1024 - the proportion of Image 1 Red to use. Green1 = 5 : As Red1 for Green. Blue1 = 6 : As Red1 for Blue. Red2 = 7 : 0 to 1024 - the proportion of Image 2 Red to use. Green2 = 8 : As Red2 for Green. Blue2 = 9 : As Red2 for Blue. Produce = 10 : Set to 0 to not render this frame, 1 otherwise. RPlus = 11 : 0 to 255 to add to Red in rendered image. GPlus = 12 : As RPlus for Green. BPlus = 13 : As RPlus for Blue. RMinus = 14 : 0 to 255 to subtract from Red in rendered image. GMinus = 15 : As RMinus for Green. BMinus = 16 : As RMinus for Blue. DX = 17 : 0 to ? - X amount to skip - See parameters. DY = 18 : 0 to ? - Y amount to skip - See parameters. Start = 19 : Starting frame number. The values of these parameters may be set and read using the GetValue and StoreValue functions: /* To read the value of e.g. Movement use: integer_variable = GetValue(Base,Movement) */ /* To set the value of e.g. Produce to 0 use: call StoreValue(Base,Produce,0) */ GetValue:Procedure Parse arg XBase, XAdd return C2D(IMPORT(D2C(STRIP(XBase) + (STRIP(Xadd) * 4),4),4)) StoreValue:Procedure Parse arg XBase, XAdd, XVal call EXPORT(D2C(STRIP(XBase) + (STRIP(Xadd) * 4),4),D2C(XVal,4),4) return The default values passed to the script for modification are: Movement : (1024 * Frame)/(TotalFrames + 1) Morphs (1024 * Frame)/TotalFrames Warps Red1,Green1,Blue1 : Movement Morphs 1024 Warps Red2,Green2,Blue2 : (1024 - Movement) Morphs 0 Irrelevant for Warps Produce : 1 Rendered frames 0 Frames 0 and TotalFrames+1 RPlus,GPlus,BPlus : 0 RMinus,GMinus,BMinus: 0 DX,DY : Initially set by DX and DY parameters Changing these values allows acceleration of movement, colour fades etc. and the generation of only some images (to check a long animation). Example scripts included are: FadeToBlack.TSM - Warp fade to black FadeToWhite.TSM - Warp fade to white PixelMorph.TSM - Morph by pixelating PixelWarp.TSM - Warp pixelating PreAll.TSM - Render all images Prescript.TSM - Do nothing example TSMorph.guide/AR-Postscript ARexx script run after rendering ================================ This script is run after each image is rendered. It is passed the following parameters: Frame : The current frame number, starting at Start. TotalFrames : The total number of frames being rendered. Single : Set to 1 if a Warp, 0 for a Morph. FileName : Name of file just rendered. This script can be used to change the format of the output file (by running it through a conversion program) or build an animation. Three examples are included: PostAnim.TSM - Convert to Anim Postscript.TSM - Do nothing example ToHam.TSM - Convert using PPM and Wasp TSMorph.guide/AR-Preview ARexx script to preview render ============================== This script is run if the Preview... or Preview... menu item is selected. Its purpose is to preview render the image (it can actually do anything you like). Before being called the current Settings are saved in T:TSMorph.prefs. It is passed the following parameters: Frame : The frame number to render FileName : The file name of the points file Two examples are included: Preview.TSM - Render and display 16 grey scale image PreAnim.TSM - Render and display 16 grey scale Anim TSMorph.guide/Algorithms Morphing algorithms ******************* The morphing algorithm is defined using the parameters MODE and DEPTH to TSMorph-render. The basic algorithm is to find 3 points which make a triangle around the point and morph this triangle between the start and end images. The DEPTH parameter controls how many points will be checked to form a triangle. 0 means just the closest 3 points are examined, 1 the closest 4, 2 the closest 5 etc. The MODE parameter controls both which triangle is chosen and what to do if no surrounding triangle is found. If MODE=0 2 4 ... 30 (i.e. bit 1 not set [do not add 1]) then if no triangle surrounding the point is found examining the closest points then the 3 closest points are used to decide how to morph. Otherwise the point is assumed to be stationery. If MODE=2 3 6 7 ... 30 31 (i.e. bit 2 set [add 2]) then all the closest points (the exact number controlled by DEPTH ) are examined to determine the smallest triangle. Otherwise the first surrounding triangle found is used. If MODE=4 5 6 7 12 ... (i.e. bit 3 set [add 4]) then a square algorithm is used to find the closest points. Otherwise all points are examined. Although using these MODEs could theoretically make the program run faster, it seems to generally run slower. If MODE=8 9 10 ... (i.e. bit 4 set [add 8]) then a Delauany triangle algorithm is used to find triangles. For these modes the DEPTH parameter should normally be set to 0. Also floating point calculations are still done even if INTEGER is set to YES. If MODE=16 17 ... (i.e. bit 8 set [add 16]) then the closest triangles are only calculated once at the start (based on the average of start and end). This should only be used if the points do not move a lot between the start and end images. It can speed things up a lot for a lot of frames. It does not make sense to use this for Animated Warps/Morphs. This uses a lot of memory: (DEPTH + 4) * Image_Width * Image_Height * 4 e.g. 640x512 image, DEPTH=2 uses 7.5 MB (contiguous) memory Therefore MODEs 0 and 1 should be faster than modes 2 or 3. The DEPTH parameter can also have a major effect on the rendering speed. See Benchmarks. TSMorph.guide/Benchmarks Benchmarks ========== These benchmarks are based on a Morph provided by "Al Bet Sam That I'm Not Eloquent, Nancy Colours Eggs" <91016@tayloru.edu> of two 150x150 images with 41 control points. Times are in seconds to generate the first frame on a 28MHz 68040 running in 32bit fast ram. ---------------------------------------------- | 040 version | 881 version | 000 version | Note all running on a 68040 ---------------------------------------------- |INT | FPU |INT | FPU |INT | FPU | INTEGER=YES/NO/NO --------------------------------------------------------- |MODE|DEPTH| | | AA | | | AA | | | AA | ANTIALIAS=NO/NO/YES --------------------------------------------------------- | 0 | 0 | 6.2| 9.1|13.9| |11.9| | | | | Shows the effect of DEPTH | | 5 |12.0|15.2| | | | | | | | --------------------------------------------------------- | 0 | 2 | 8.4|11.4|17.0| 8.8|14.1|18.5| 9.4|63.8|80.9| On a 68000 with 1MB chip ram, no | 1 | | 8.1| | | 8.5| | | x| | | fast ram... | 2 | | 8.9| | | | | | | | | | 4 | |13.4| |22.8|13.6| |23.3| | | | x = 262 (9.4 * 28) | 8 | | 7.6| | | | | | | | | | 16 | | 2.8| |10.7| | |12.1| | | | | 17 | | 2.5| | 8.9| 2.6| |10.3| 3.2| |45.5| --------------------------------------------------------- | 8 | 0 | 6.4| | | | | | | | | --------------------------------------------------------- | 15 | 0 | 7.1| | | | | | | | | --------------------------------------------------------- | 16 | 0 | 1.7| 4.6| 9.5| 1.7| 6.7|10.6| 2.5|56.0| | --------------------------------------------------------- TSMorph.guide/File_Names File naming *********** File names can include the frame number. The format of the frame number in the file name is specified using the following formats: %ld : Number left justified e.g. '1','2',..,'10',..,'123',.. %3ld : Number right justified e.g. ' 1',' 2',..,' 10',..,'123',.. %03ld : Number right justified e.g. '001','002',..,'010',..,'123',.. Where the number can be changed e.g. pic.%04ld for Imagine 2.0 produced files pic%03ld for Vista produced files name%ld for files to run through mpeg TSMorph.guide/Errors Error Messages ************** The following messages can be displayed in an Error Requester. Both Images must be the same size Unable to Open Grid Requester Both X Cells and Y Cells must be > 0 Out of memory for points No ILBM.BMHD chunk Failed to allocate raster No ILBM.BODY chunk Not an ILBM Clipboard open failed xxxx; File open failed Parsing error; no top chunk Not enough memory Failure opening TSMorph Window Failure setting up screen Can not Open xxxx.library(n) Unable to Allocate FileRequest Unable to Create Window Message Port Can not Open input.device Image smaller than points Images different sizes Unable to Allocate Zoom raster Unable to SetMenuStrip Unable to OpenWindowTags Unable to AllocMem for Filename Unable to Allocate xxxx Gadget Unable to Allocate xxxx Image Failure loading Image 'xxxx' Unable to AllocIFF Unable to AllocMem for ILBMInfo Unable to GetScreenDrawInfo Unable to LockPubScreen(xxxx) Invalid file format - Line 'xxxx' Images are too small Point out of range - Line 'xxxx' Out of memory for points Invalid point link - Line 'xxxx' Error closing file 'xxxx' Error opening file 'xxxx' Error writing to 'xxxx' Point already linked to 16 points Point not linked Cannot link point to itself Points already linked Cannot unlink point from itself Error no memory for new point Unable to Open xxxx.library(n) Error saving file 'xxxx' Error AllocVec for output Error Opening points file Error opening progress window Unable to allocate memory for bitmap Image must be 24 bit 'xxxx' Error loading 'xxxx' Size does not match image - Line 'xxxx' Out of memory for points Must have at least 3 points Error sending ARexx message - 'xxxx' Assuming version 1.0 file format Must have at least one frame Frames must all be the same size Failure - yyyy - loading 'xxxx' Error Saving Settings 'xxxx' Error Loading Settings 'xxxx' No opal.library File does not exist 'xxxx' Error opening screen Unable to get DrawInfo Unable to lock Workbench Invalid screen mode xxxx TSMorph is attempting to close this ... TSMorph.guide/Err-Size Error - Both Images must be the same size ========================================= This message should never be displayed. Images different sizes should be displayed instead. Resolution - None required. TSMorph.guide/Err-OpenGrid Unable to Open Grid Requester ============================= TSMorph is unable to open the Add Grid requester. The normal reason would be lack of memory. Resolution - Free up some memory and retry. TSMorph.guide/Err-Grid0 Error - Both X Cells and Y Cells must be > 0 ============================================ This message is displayed if the Add Grid requester is used and either the X Cells or Y Cells is set to 0. The minimum allowed value is 1. Resolution - Input at least 1 in both gadgets, or cancel the requester. TSMorph.guide/Err-MemoryPoints Error - Out of memory for points ================================ This message is displayed after the Add Grid requester has been used and points and lines are being added to the images. Insufficient memory is available. Resolution - Since it is possible that some of the points have been added to the images then you may wish to use the New Points menu item to delete all points. Then free up some memory and retry. TSMorph.guide/Err-IFFBMHD Error - No ILBM.BMHD chunk ========================== The Image being loaded has no BMHD chunk. Resolution - Specify the name of a correct ILBM image. TSMorph.guide/Err-IFFRaster Error - Failed to allocate raster ================================= There is insufficient memory to load the ILBM image. Resolution - Free up some memory and retry. TSMorph.guide/Err-IFFBODY Error - No ILBM.BODY chunk ========================== The Image being loaded has no BODY chunk. Resolution - Specify the name of a correct ILBM image. TSMorph.guide/Err-IFFILBM Error - Not an ILBM =================== The Image being loaded is not and ILBM file. Resolution - Specify the name of a correct ILBM image. TSMorph.guide/Err-IFFCLIP Error - Clipboard open failed ============================= The program is unable to open the specified clipboard. Resolution - Retry with the correct clipboard number, or use a different file name. TSMorph.guide/Err-IFFFileS Error - xxxx; File open failed ============================== File xxxx can not be successfully opened. The file does not exist (if trying to read), is already in use, or the filename is invalid. Resolution - Retry with a valid file name. TSMorph.guide/Err-IFFTop Error - Parsing error; no top chunk =================================== This is a technical error which should never occur. Resolution - Unknown. TSMorph.guide/Err-IFFMemory Error - Not enough memory ========================= There is insufficient memory to save or load the IFF ILBM file. Resolution - Free up some memory and retry. TSMorph.guide/Err-OpenTSMorph Error - Failure opening TSMorph Window ====================================== The Information Window window could not be opened. There is probably insufficient memory. Resolution - Free up some memory and retry. TSMorph.guide/Err-SetupScreen Error - Failure setting up screen ================================= The Information Window window could not be opened. Either the Public Screen is not open or there is insufficient memory. Resolution - Free up some memory and retry, or correct the PUBSCREEN parameter. TSMorph.guide/Err-Library Error - Can not Open xxxx.library(n) ==================================== The library xxxx version number n could not be opened. See Requirements for a list of libraries required. It could just be a lack of memory. Resolution - Ensure you are running at least version 2.04 of the operating system, or free up some memory and retry. TSMorph.guide/Err-FileReq Error - Unable to Allocate FileRequest ====================================== Insufficient memory is available. Resolution - Free up some memory and retry. TSMorph.guide/Err-WPort Error - Unable to Create Window Message Port ============================================ Insufficient memory is available. Resolution - Free up some memory and retry. TSMorph.guide/Err-IDevice Error - Can not Open input.device ================================= Insufficient memory is available. Resolution - Free up some memory and retry. TSMorph.guide/Err-ISmall Error - Image smaller than points ================================= The image trying to be loaded is smaller than the points already defined. Resolution - Load a larger image, or select the New menu item and restart. TSMorph.guide/Err-IDifferent Error - Images different sizes ============================== This can be displayed when opening the second image in TSMorph. Both images must have the same horizontal and vertical resolutions. The image depths can be different. Resolution - Either use a different pair of images, or change the size of one of the images using some image-processing program. TSMorph.guide/Err-ZRaster Error - Unable to Allocate Zoom raster ====================================== Insufficient memory is available. Resolution - Free up some memory and retry. If you still do not have enough memory then rerun specifying ZOOM=OFF as a parameter. TSMorph.guide/Err-Menu Error - Unable to SetMenuStrip ============================== Insufficient memory is available. Resolution - Free up some memory and retry. TSMorph.guide/Err-OpenWindow Error - Unable to OpenWindowTags ================================ Insufficient memory is available. Resolution - Free up some memory and retry. TSMorph.guide/Err-MemFile Error - Unable to AllocMem for Filename ======================================= Insufficient memory is available. Resolution - Free up some memory and retry. TSMorph.guide/Err-AllocGadget Error - Unable to Allocate xxxx Gadget ====================================== Insufficient memory is available. Resolution - Free up some memory and retry. TSMorph.guide/Err-AllocImage Error - Unable to Allocate xxxx Image ===================================== Insufficient memory is available. Resolution - Free up some memory and retry. TSMorph.guide/Err-LoadImage Error - Failure loading Image 'xxxx' ==================================== There was an error loading the image xxxx. Another error message should previously have been displayed. Resolution - See previous error message. TSMorph.guide/Err-AllocIFF Error - Unable to AllocIFF ========================== Insufficient memory is available. Resolution - Free up some memory and retry. TSMorph.guide/Err-AllocILBM Error - Unable to AllocMem for ILBMInfo ======================================= Insufficient memory is available. Resolution - Free up some memory and retry. TSMorph.guide/Err-GetDRI Error - Unable to GetScreenDrawInfo =================================== Insufficient memory is available. Resolution - Free up some memory and retry. TSMorph.guide/Err-LockScreen Error - Unable to LockPubScreen(xxxx) ===================================== Either the Public Screen is not open or there is insufficient memory. Resolution - Free up some memory and retry, or correct the PUBSCREEN parameter. TSMorph.guide/Err-FileFormat Error - Invalid file format - Line 'xxxx' ========================================= The points file being loaded is in an incorrect Format or is not a points file. Resolution - Specify a correct points file or manually edit the file and retry. TSMorph.guide/Err-TooSmall Error - Images are too small ============================ The images specified in the input file are too small. Resolution - Either edit the input file - See Format , or select the New menu item and retry. TSMorph.guide/Err-Range Error - Point out of range - Line 'xxxx' ======================================== The point coordinates specified in the input file is larger than the image size. Resolution - Manually edit the input file - See Format and retry. TSMorph.guide/Err-MemPoints Error - Out of memory for points ================================ Insufficient memory is available. Resolution - Free up some memory and retry after selecting either New or New Points to delete existing points. TSMorph.guide/Err-InvalidLink Error - Invalid point link - Line 'xxxx' ======================================== The points linking specified in the input file is invalid. Resolution - Manually edit the input file - See Format and retry. TSMorph.guide/Err-CloseFile Error - Error closing file 'xxxx' ================================= The file xxxx could not be successfully closed. The disc may be full. Resolution - If saving then save the file to a different disk or free up some disk space and retry with another name. The original file may not be accessible until after a reboot. TSMorph.guide/Err-OpenFile Error - Error opening file 'xxxx' ================================= The file xxxx could not be opened. The file does not exist (when reading), the name is invalid, the file is already in use, or the disk is write protected. Resolution - Use a different file name or allow the disk to be written to. TSMorph.guide/Err-WriteFile Error - Error writing to 'xxxx' =============================== The file xxxx could not be successfully written to. The disc may be full. The file has not been successfully saved. Resolution - Save the file to a different disk or free up some disk space and retry. TSMorph.guide/Err-4Points Error - Point already linked to 16 points ========================================= Any point can only be linked to up to 16 other points. Note: the links are only for clarity and do not effect the rendering process. Resolution - Unlink the current point from some other point and retry. TSMorph.guide/Err-NotLinked Error - Point not linked ======================== The points just selected are not currently linked and cannot therefore be unlinked. Resolution - None required. TSMorph.guide/Err-LinkSelf Error - Cannot link point to itself =================================== A point can not be Linked to itself. Resolution - Select another point to link to. TSMorph.guide/Err-Linked Error - Points already linked ============================= The points you are trying to link are already linked. Resolution - None required. TSMorph.guide/Err-UnlinkSelf Error - Cannot unlink point from itself ======================================= A point can not be unlinked from itself. Resolution - Select another point to unlink from. TSMorph.guide/Err-MemNewPoint Error - Error no memory for new point ===================================== There is no memory to add the new point. Resolution - Free up some memory and retry. TSMorph.guide/Err-LibraryR Error - Unable to Open xxxx.library(n) ====================================== The library xxxx version number n could not be opened. See Requirements for a list of libraries required. It could just be a lack of memory. Resolution - Ensure you are running at least version 2.04 of the operating system, or free up some memory and retry. TSMorph.guide/Err-Saving Error - Error saving file 'xxxx' ================================ Some error occurred saving the IFF ILBM output file. Another error requester may have previously appeared. Alternatively there could be a lack of memory. This error is also displayed when trying to save DCTV images in an invalid size. Resolution - See the previous error message, or free up some memory and retry. TSMorph.guide/Err-AllocVec Error - Error AllocVec for output ================================= Insufficient memory is available. Resolution - Free up some memory and retry. TSMorph.guide/Err-OpenPoints Error - Error Opening points file ================================= The input file specified to TSMorph-render does not exist or is in an invalid format. Resolution - Either specify a valid input file, or manually edit the points file. TSMorph.guide/Err-Progress Error - Error opening progress window ===================================== Some error occurred opening the Progress requester in TSMorph-render. Probably a lack of memory, or the PUBSCREENR parameter specifies a not open public screen name. Resolution - Free up some memory or correct the parameter and retry. TSMorph.guide/Err-AllocPlanes Error - Unable to allocate memory for bitmap ============================================ Insufficient memory is available for some bitmap planes. Resolution - Free up some memory and retry. TSMorph.guide/Err-24 Error - Image must be 24 bit 'xxxx' =================================== The image xxxx being loaded by TSMorph-render is not a 24 bit image. Only 24 bit ILBM images can be rendered. This is an obsolete message which should not appear. Resolution - Use TSMorph to specify a valid 24 bit ILBM image. TSMorph.guide/Err-Load Error - Error loading 'xxxx' ============================ The image xxxx being loaded by TSMorph-render could not be loaded. A previous error requester could have appeared. The file name could be invalid. Resolution - See the previous error message. TSMorph.guide/Err-SizeMatch Error - Size does not match image - Line 'xxxx' =============================================== The points file being loaded - See File Format - has an image size specified which does not match the image being loaded. Resolution - Change the image size, manually edit the input file, or respecify the image name using TSMorph. TSMorph.guide/Err-MemPointsR Error - Out of memory for points ================================ Insufficient memory is available. Resolution - Free up some memory and retry. TSMorph.guide/Err-3Points Error - Must have at least 3 points =================================== In order to correctly render an image at least 3 points must be defined. Resolution - Use TSMorph to define at least 3 points - e.g. in 3 of the corners. TSMorph.guide/Err-ARexx Error - Error sending ARexx message - 'xxxx' ============================================ TSMorph-render or TSMorph has had a problem sending the ARexx message. ARexx may not be running, or the script may not exist or have errors. Resolution - Ensure ARexx is running, check the scripts - See parameters PRESCRIPT , POSTSCRIPT and LOADSCRIPT , or PREVIEW - exist and have TSM as a suffix. If the above is OK then use TCO and TS to interactively trace the script. TSMorph.guide/Err-OldFormat Error - Assuming version 1.0 file format ======================================== The current version of the File Format has a header record. This error is saying no header is present, it is assumed that the file is in an old format. Resolution - Select OK to continue. Load and Save in TSMorph to save in the new format if required. TSMorph.guide/Err-OneFrame Error - Must have at least one frame ==================================== This is displayed when trying to edit points on an Animated Morph/Warp when the number of frames is 0. Resolution - Set the number of frames to at least 1. TSMorph.guide/Err-AllSize Error - Frames must all be the same size ======================================== This is displayed when trying to change to a different frame. The size of all input images must be the same. Resolution - Ensure all input images are the same size. TSMorph.guide/Err-OpalVision Error - Failure - yyyy - loading 'xxxx' ======================================= opal.library had a problem loading image xxxx. Resolution - yyyy should describe the problem. TSMorph.guide/Err-SaveS Error - Error Saving Settings 'xxxx' ==================================== This message is displayed when TSMorph has been unable to save settings in the named file. If KEEPSETTINGS is set to YES then settings are saved in ENV:TSMorph/TSMorph.prefs when the program is quit. Resolution - Supply a correct filename, set KEEPSETTINGS to NO, or create the directory ENV:TSMorph TSMorph.guide/Err-LoadS Error - Error Loading Settings 'xxxx' ===================================== TSMorph has had a problem loading the specified file. The file probably does not exist. Resolution - Specify a correct file name TSMorph.guide/Err-NoOpal Error - No opal.library ======================= TSMorph or TSMorph-render is trying to load an image using opal.library but it could not be opened. Resolution - For TSMorph - If you do not have opal.library do not specify OPENMODE=OPAL. If you are not specifying this then the image you are trying to load must be in a format which TSMorph does not understand (this may be some unsupported JPEG variant). For TSMorph-render - This is trying to load some unsupported image format. TSMorph.guide/Err-NoFile Error - File does not exist 'xxxx' ================================== TSMorph is trying to load an image from a file which does not exist or is inaccessible. Resolution - Specify a valid file name. TSMorph.guide/Err-OScreen Error - Error opening screen ============================ TSMorph has been unable to open the requested screen. This could be because the CUSTOMDEPTH is too great for the CUSTOMMODE , there is not enough memory, or some other related reason. Resolution - Check you have enough memory, make sure the screen depth is OK for the screen mode. TSMorph.guide/Err-DrawI Error - Unable to get DrawInfo ============================== TSMorph has been unable to obtain some information from the Workbench, probably due to lack of memory. Resolution - Free up some memory and retry. TSMorph.guide/Err-LockW Error - Unable to lock Workbench ================================ TSMorph has been unable to obtain some information from the Workbench, probably due to lack of memory. Resolution - Free up some memory and retry. TSMorph.guide/Err-SMode Invalid screen mode xxxx ======================== The screen mode specified by CUSTOMMODE is not a valid screen mode. Resolution - Check the screen mode against the list show in the preferences screen mode requester. TSMorph.guide/Err-CScreen TSMorph is attempting to close this ... ======================================= TSMorph is trying to close the Public Screen that it opened but is unable to as there are locks (probably open windows) on the screen. Resolution - Close all other open windows on the screen and retry. TSMorph.guide/Bugs Known (and unknown errors) ************************** * Known Problems * Unsaved project does not check that gadgets really have been edited. * This guide sometimes has very long lines. Also bold items following * are followed by too many spaces. This appears to be due to a problem with MakeInfo, menus and lists. * This guide may not look correct when using amigaguide.library versions before 40. This will not be fixed. * Fails to do anything if run on less than 2.04 (could display a message). This is unlikely to be fixed. * Progress gadgets do not look to good using 2.04. They do look OK when using 3.0+. This will not be fixed. * 24 bit ILBMs are loaded into Chip memory. If you do not have enough, then convert the input images to PPM or JPEG first. (Thanks to Jamie Cope). * Sizing EGS windows from the top or left may corrupt the display. I believe this an EGS problem. * Unknown Problems? * Image validation requires tidying up - especially with anim morphs/warps. * TSMorph and TSMorph-render may not release all memory. * TSMorph-prefs has not been well tested. * TSMorph may open zoomed large windows with corruption. * Width and Height in the parameter file may not be correctly set and require manual editing. Please report any other bugs by EMail to mark@topic.demon.co.uk or mpaddock@cix.compulink.co.uk. TSMorph.guide/Hard-Software Hardware and Software used in development ***************************************** * HSPascal Editor. * SAS C Code. * GadToolsBox Info, Add Grid and Progress Windows. GadToolsBox is © Copyright 1991,92 Jaba Development. * DPaint Control Window gadgets/Pointers. * Workbench 2.04 GUI. * MakeInfo Documentation. * Iff2Src Control Window gadgets. Iff2Src is © J Tyberghein. * ILBMtoC Pointers. * IconEdit Pointers. * NewIff Various IFF routines. * ReqTools For nicer requesters. ReqTools is © 1991/1992 Nico François * OpalVision For opal.library for easy file loading and saving. OpalVision is a trademark of Opal Technology Pty Ltd. * DCTV For dctv.library for saving and loading DCTV images. DCTV is © 1991,1992 Digital Creations, Inc. * IJG JPEG software For the PPM, TARGA, GIF and JPEG file loading code. * EGS For the EGS interface. * AG2TXT For the .doc file. AG2TXT is Copyright (c) 1993 Jason R. Hulance. * Fenster To capture the windows * MKANIM To generate Animations. MKANIM is Copyright © 1993 by John Bickers. * Viewtek To display Animations. Viewtek is © 1992 Thomas Krehbiel. * Commodore Amiga 2000 with 1MB chip ram, * Commodore 1960 monitor, * GVP SCSI hard card with 52MB Quantum disc, * RCS Fusion Forty accelerator with 8MB fast ram. TSMorph.guide/History Version History (since 2.0) *************************** * Version 3.2 * Recompiled using SAS/C 6.55. Runs about 3% faster. * TSMorph.guide now looks almost OK under AmigaGuide 3.1. * Version 3.1 * Fixed the installer script to run correctly on all processors. (Thanks to Olivier Jeannet). * Fixed the Rexx scripts to run correctly when running in ram in the 24bit address space. (Thanks to Olivier Jeannet). * Help gadget now works better. * Some code fixes for more recent EGS versions. * Version 3.0 * Recompiled using SAS/C 6.51. * Added 68040 version. * Now correctly handles AGA palettes. * Installer now included. (Thanks to Perry Horner). * Fixed a problem with the EGS pointer (Thanks to Darren Eveland). * Version 2.5 * Major Enhancements * Added EGS support to TSMorph and TSMorph-render. * Added INTEGER parameter to TSMorph-render. This should make the program run faster, but the output will not be as good. The Icon supplied for the non FPU version has INTEGER=YES set by default, the default preview script also sets this. * Added MODEs 4 to 31. This changes the Settings menu. * Added Triangulate menu item to convert point links to triangles. Points can now be linked to up to 16 other points. * Added a short tutorial - See Tutorial/Tutorial.readme. * Added documentation in plain text format - See TSMorph.doc. (Thanks to Perry Horner). * Added documentation in .html format - Mosaic is required to view this. * Minor Enhancments * Edited the graphics in this guide. It will only look correct under the OS3.0+ version of AmigaGuide.library. * When trying to close the Public Screen TSMorph will display an error if any other windows are open. * Horizontal and Vertical gadgets are now correct on 2 colour screens. * Added REQTOOLS parameter to TSMorph and TSMorph-render. * TSMorph-render now uses nofrag.library for memory allocation if available. * Added new prescript example script to render all frames. * Added new Hints & Tips section. * Sped up the remapping of normal ILBM images. * Install script now determines 68020/881 correctly itself. * Added some new ARexx scripts to generate animations. * Bug Fixes * Fixed a very silly bug with the DEPTH parameter. It was always read as at least 20. This should speed up rendering. * TSMorph-prefs and TSMorph set ANTIALIAS and HELP correctly when Reset to Defaults. * Some fixes to the default PREVIEW script. (Thanks to Stefan Haubenthal). * TSMorph-prefs now correctly sets the Render mode. * Output images should not have garbage on the right hand side. * Lots of minor code and docs changes. * Version 2.4 * Fixed bug where if 1st image for a Morph was loaded to convert the first frame then the second image was never loaded. * Version 2.3 * Enhancements * Keyboard shortcuts added to Edit windows to change Edit Mode (this prevents any screen flicker when CHANGEPALLETE is set to YES). * Bug Fixes * Sensible message is displayed if opal.library is not present and an input image does not exist in TSMorph-render. * TSMorph-render no longer attempts to load unnecessary images and point files for the first and last frames. * PREVIEW can now be longer than the default value without causing public screen name problems. * TSMorph-prefs no longer resets preferences to defaults if Open... is cancelled. * Zoom? menu item now works on the Info window. * No longer opens project SETTINGS= settings file twice. * Title of file requester to Open Project is now Load Project not Load File. * Major source code clean up. * Source code is now available. Distribution is under GNU General Public Licence. See distribution. * Version 2.2 * Major Enhancements * Added Anti-Alias capability to TSMorph-render. * Added ability to TSMorph and TSMorph-render to load a large variety of image formats (JPEG, ILBM (including 24 bit, EHB, HAM6, HAM8 and DCTV with dctv.library), TARGA, GIF and PPM). See OPENMODE and LOADSCRIPT. * Added a lot more save formats (grey 16, grey 256, HAM 6, HAM 8 and DCTV3 and DCTV4 [with dctv.library]). * Added continuous help option, and Help Text gadget to TSMorph. * Added the Preview option to preview render an image. See Preview... , Preview... and PREVIEW. * Added the ability to open custom screens. * Can now save the first and last images - see Prescript. * Added preferences editor TSMorph-prefs. * Minor Enhancements * Loading Image requester is displayed. See OPENMODE. * 24 File 1 and 24 File 2 gadgets can now be left blank to use the File One and File Two names. * MakeInfo 1.55 used. This doc now has more formatting. * Progress requester now shows a list view of messages. * Bug Fixes * Image remapping should be more correct. * Edit/Mode sub-menu has a capital E. * Should no longer leave the Screen with the incorrect palette when TSMorph is quit. * Fixed a nasty memory corruption bug with DX and DY. * Control Window gadgets now look more correct on screens with more than 4 colours. * Fixed a bug where parameters were automatically reset when opening a project. * Open Points... no longer resets Morph parameters. * Load Settings... now works. * DEPTH parameter can now be greater than the number of points without memory corruption. * TSMorph window is correctly disabled when saving after Unsaved Project requester is displayed. * Uses less memory for Zoom raster. * TSMorph opens amigaguide window on screen specified by PUBSCREEN. * String requesters will now accept empty strings. * Version 2.0a * Minor update to the File Format description. (Includes Anim Morphs and Warps). * ENV/TSMorph/def_points now has Stack set to 8192. (Prevents crashes when using opal.library). * Render Public Screen menu item is disabled if reqtools.library is not available. (Previously crashed if selected). * Only relevant OPENMODE is ALWAYS if opal.library is not available (Thanks to spark@cix). * Screen is automatically brought to the front when the first window opens. TSMorph.guide/Hints Hints & Tips ************ This section supplies some hopefully useful information which may not be immediately apparent elsewhere. Speed? If you do not have an FPU then set the INTEGER parameter to YES. Even if you do have an FPU this may still make things run faster. If it still slow then try changing DX and DY to 1 (or more). If you have lots of memory then setting the precalculate part of MODE (16) should help. What MODE? This depends on the type of Morph. If you are, say, rotating some text on a background, then it is probably best to set the stationary part (1). You would NOT want to set the precalculate once part (16). If you are morphing, say, two faces where the points do not move much between the first and last image then it may be best to set the precalculate part (16) (provided you have enough free memory). Setting the Delaunay part (8) may also be a good idea. Setting search (2) is probably not a good idea. Not enough memory for TSMorph If you run out of Chip memory when trying to load large images then try setting ZOOM to OFF. HAM output has fringing A very simple algorithm is used for generating HAM output. If the output is not acceptable then the best idea is to output some other format (ILBM24 or PPM) and then run a proper image conversion program on the output (possibly as part of the Postscript script). TSMorph.guide/Distribution Copyright and distribution requirements *************************************** TSMorph - Amiga Morphing program Copyright (C) © 1993/94 Topicsave Limited This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. mark@topic.demon.co.uk mpaddock@cix.compulink.co.uk TSMORPH IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE; NO WARRANTIES ARE MADE. ALL USE IS AT YOUR OWN RISK. NO LIABILITY OR RESPONSIBILITY IS ASSUMED. TSMorph is ©1993/94 Topicsave Limited. Please send any criticisms, bugs, etc. by EMail to mark@topic.demon.co.uk or mpaddock@cix.compulink.co.uk. This software is based in part on the work of the Independent JPEG Group. The Graphics Interchange Format(c) is the Copyright property of CompuServe Incorporated. GIF(sm) is a Service Mark property of CompuServe Incorporated. The Delaunay code was written by Dave Watson and uses the algorithm described in - Watson, D.F., 1981, Computing the n-dimensional Delaunay tessellation with application to Voronoi polytopes: The Computer J., 24(2), p. 167-172. Installer and Installer project icon (c) Copyright 1991-93 Commodore-Amiga, Inc. All Rights Reserved. Reproduced and distributed under license from Commodore. INSTALLER SOFTWARE IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE; NO WARRANTIES ARE MADE. ALL USE IS AT YOUR OWN RISK. NO LIABILITY OR RESPONSIBILITY IS ASSUMED. TSMorph.guide/TSMorph-prefs Preferences editor ****************** TSMorph-prefs is a standard preferences editor. When loaded it loads the current settings from ENV:TSMorph/TSMorph.prefs. It then displays a window showing all the preferences. Help displays context sensitive help using amigaguide if available. Gadgets Gadgets displayed in the Preferences Window Menus Menus available in the Preferences Window TSMorph.guide/TSMP-gad TSMorph-prefs Gadgets ===================== ---------------------------------------------------------- |. | TSMorph Preferences | | | |--------------------------------------------------------| | Custom Screen Render TSMorph | | NONE---------| DX |--- 0 DY |--- 0 Zoom YES | | PAL:Low Res--| Mode Palette YES | | PAL:High Res-| Save Format --|- 75 ModeIFCOLOURS | | Depth --|--- 4 AAx Intx Dep-|- 5 Prefsx Helpx | | | | ARexx Script Public Screen | | Preview ................... TSMorph ................ | | Load ................... Render ................ | | Pre ................... Icon | | Post ................... Projectx Prefsx Renderx | | | | Save Use Cancel | ---------------------------------------------------------- System gadgets Close Close gadget Zoom Zoom gadget Depth gadget Depth gadget Custom Screen Screen mode Custom screen mode Depth Custom screen depth Render DX Render X skip DY Render Y skip Mode Render mode Save Format Render image format Quality JPEG Quality AA AntiAlias images Int Use Integer maths Dep Rendering depth TSMorph Zoom Zoom images Palette Change palette Mode Open mode Prefs Keep preferences Help Continuous help ARexx Script Preview Preview script Load Load image script Pre Pre render script Post Post render script Public Screen TSMorph TSMorph public screen Render Render public screen Icon Project Project Icons Prefs Preferences Icons Render Render Icons Exit gadgets Save Save preferences Use Use preferences Cancel Cancel TSMorph.guide/TSMP-Close TSMorph-prefs Close gadget -------------------------- This closes the window and discards any changes. TSMorph.guide/TSMP-Zoom TSMorph-prefs Zoom gadget ------------------------- This is a standard zoom gadget and zooms the window to/from a title bar. TSMorph.guide/TSMP-Depth TSMorph-prefs Depth gadget -------------------------- This is a standard depth gadget. TSMorph.guide/TSMP-Save TSMorph-prefs Save gadget ------------------------- This save the settings in ENV:TSMorph/TSMorph.prefs and ENVARC:TSMorph/TSMorph.prefs. Any changes are not picked up until TSMorph or TSMorph-render is reloaded. TSMorph.guide/TSMP-Use TSMorph-prefs Use gadget ------------------------ This save the settings in ENV:TSMorph/TSMorph.prefs. Any changes are not picked up until TSMorph or TSMorph-render is reloaded. TSMorph.guide/TSMP-Cancel TSMorph-prefs Cancel gadget --------------------------- This closes the window and discards any changes. TSMorph.guide/TSMP-men TSMorph-prefs Menus =================== The following menus are available on the TSMorph-prefs Window: Project Project menu Edit Edit menu Settings Settings menu TSMorph.guide/TSMP-men-Project TSMorph-prefs Project menu -------------------------- This menu contains the following items with their associated Amiga short-cuts in the TSMorph-prefs Window: Open... O Open a preferences file Save As... S Save a preferences file Quit Q Quit TSMorph.guide/TSMP-men-P-Open TSMorph-prefs Project/Open... menu item ....................................... This displays a file requester to load the settings. The default name is TSMorph.prefs in the current directory. TSMorph.guide/TSMP-men-P-SaveAs TSMorph-prefs Project/Save As... menu item .......................................... This displays a file requester to save the settings. The default name is TSMorph.prefs in the current directory. TSMorph.guide/TSMP-men-P-Quit TSMorph-prefs Project/Quit menu item .................................... This closes the window and discards any changes. TSMorph.guide/TSMP-men-Edit TSMorph-prefs Edit menu ----------------------- This menu contains the following items with their associated Amiga short-cuts in the TSMorph-prefs Window: Reset To Defaults D Reset preferences to defaults Last Saved L Load preferences from ENVARC: Restore R Load preferences from ENV: TSMorph.guide/TSMP-men-E-ResetD TSMorph-prefs Edit/Reset To Defaults menu item .............................................. This resets the settings to their default values. TSMorph.guide/TSMP-men-E-LastS TSMorph-prefs Edit/Last Saved menu item ....................................... This loads the settings from ENVARC:TSMorph/TSMorph.prefs. TSMorph.guide/TSMP-men-E-Restore TSMorph-prefs Edit/Restore menu item .................................... This loads the settings from ENV:TSMorph/TSMorph.prefs. TSMorph.guide/TSMP-men-Settings TSMorph-prefs Settings menu --------------------------- This menu contains the following items with their associated Amiga short-cuts in the TSMorph-prefs Window: Create Icons? I Create preference Icons TSMorph.guide/TSMP-men-S-Icons TSMorph-prefs Settings/Create Icons? menu item .............................................. This item toggles if Icons are to be saved with Settings files. If it is selected then an Icon will be saved. The icon will come from ENV:TSMorph/def_prefs if this exists, secondly from ENV:SYS/def_prefs, otherwise the default project Icon is used. This menu item is similar to but can have a different value to the CREATEICONSP parameter. TSMorph.guide/Index Index ***** 24 File 1 gadget I-gad-24_File_1 24 File 2 gadget I-gad-24_File_2 About Req-About About... menu item CI-men-P-About About... menu item I-men-P-About Add EMode-Add Add Grid Req-Add_Grid Add Grid... menu item CI-men-E-Grid Algorithms Algorithms ANTIALIAS= Par-TSMorph-render ARexx AR Benchmarks Benchmarks Bugs Bugs Cancel gadget Req-Add_Grid-gad-Cancel Cancel gadget TSMP-Cancel CHANGEPALETTE= Par-TSMorph Close gadget Con-gad-Close Close gadget Req-Add_Grid-gad-Close Close gadget TSMP-Close Close gadget E-gad-Close Close gadget I-gad-Close Control gadgets Con-gad Control keyboard controls Con-Key Control menus CI-men Control Window Con Copyright Distribution Create Icons? menu item TSMP-men-S-Icons CREATEICONS= Par-TSMorph CREATEICONSR= Par-TSMorph CREATEICONSR= Par-TSMorph-render Del EMode-Delete Delete EMode-Delete Delete... menu item I-men-P-Delete Depth gadget I-gad-Depth Depth gadget TSMP-Depth Depth gadget E-gad-Depth Depth gadget Con-gad-Depth DEPTH= Par-TSMorph-render Distribution Distribution Down gadget E-gad-Down DX= Par-TSMorph-render DY= Par-TSMorph-render Edit gadgets E-gad Edit keyboard commands E-Key Edit menu CI-men-E Edit menu TSMP-men-Edit Edit menu TSMP-men-Settings Edit menus CI-men Edit Mode sub menu CI-men-E-EMode Edit Modes EModes Edit Points menu item I-men-P-Edit_Points Edit Points... gadget I-gad-Edit_Points Edit Windows Edit EGS= Par-TSMorph EGS= Par-TSMorph-render Error Req-Error Error Messages Errors Errors Bugs Exit Point menu item CI-men-P-Exit_Points File Format File_Format File naming File_Names File One gadget I-gad-File_One File Two gadget I-gad-File_Two FILES= Par-TSMorph FILES= Par-TSMorph-render First gadget Con-gad-First First menu item CI-men-E-Frame-First Format File_Format Frame Req-Progress Frame Number Req-FrameNumber Frame sub menu CI-men-E-Frame Frames gadget I-gad-Frames Get 24 File 1 gadget I-gad-Get_24_File_1 Get 24 File 2 gadget I-gad-Get_24_File_2 Get File One gadget I-gad-Get_File_One Get File Two gadget I-gad-Get_File_Two Get Name gadget I-gad-Get_Name GetValue AR-Prescript Goto gadget Con-gad-Goto Goto item CI-men-E-Frame-Goto Hardware Hard-Software Height gadget I-gad-Height Help Text gadget I-gad-Help HELP= Par-TSMorph Hints Hints History History Horizontal scroll bar E-gad-Horiz Info gadgets I-gad Info keyboard controls I-Key Info menus I-men Information Window Info Installation Installation INTEGER= Par-TSMorph-render Interface Interface KEEPSETTINGS= Par-TSMorph L1 EMode-Link L2 EMode-Link Last gadget Con-gad-Last Last item CI-men-E-Frame-Last Last Saved menu item TSMP-men-E-LastS Left gadget E-gad-Left Libraries Requirements Line Req-Progress Link EMode-Link List of files Installation Lnk EMode-Link Loadscript AR-Loadscript LOADSCRIPT= Par-TSMorph-render MODE= Par-TSMorph-render Modes EModes Mouse Pointer EModes Mov EMode-Move Move EMode-Move Name gadget I-gad-Name New menu item I-men-P-New New Points menu item CI-men-P-New Next gadget Con-gad-Next Next item CI-men-E-Frame-Next None EMode-Move OK gadget Req-Add_Grid-gad-OK One EMode-One Open menu item TSMP-men-P-Open Open menu item I-men-P-Open Open Points menu item CI-men-P-Open OPENMODE= Par-TSMorph Overview Overview Parameter files File_Format Parameters Par Pointer EModes Postscript AR-Postscript POSTSCRIPT= Par-TSMorph-render Preferences editor TSMorph-prefs Prescript AR-Prescript PRESCRIPT= Par-TSMorph-render Preview menu item I-men-P-Preview Preview menu item CI-men-P-Preview PREVIEW= Par-TSMorph Previous gadget Con-gad-Previous Previous menu item CI-men-E-Frame-Previous Progress Req-Progress Project menu CI-men-P Project menu I-men-P Project menu TSMP-men-Project PUBSCREEN= Par-TSMorph PUBSCREENR= Par-TSMorph-render QUALITY= Par-TSMorph-render Quit menu item CI-men-P-Quit Quit menu item I-men-P-Quit Quit menu item TSMP-men-P-Quit Really quit? Req-Really_quit Rel EMode-Relative Relative EMode-Relative REQTOOLS= Par-TSMorph REQTOOLS= Par-TSMorph-render Requesters Req Requirements Requirements Reset To Defaults menu item TSMP-men-E-ResetD Restore menu item TSMP-men-E-Restore Right gadget E-gad-Right Save As menu item TSMP-men-P-SaveAs Save As... menu item CI-men-P-Save_As Save As... menu item I-men-P-Save_As Save gadget TSMP-Save Save menu item I-men-P-Save Save menu item CI-men-P-Save SAVEFORMAT= Par-TSMorph-render Settings menu men-Settings SETTINGS= Par-TSMorph SETTINGS= Par-TSMorph-render SETTINGS= Par Single gadget I-gad-Single Size gadget E-gad-Size Software Hard-Software Start gadget I-gad-Start Stop Req-Progress StoreValue AR-Prescript Tips Hints Tool types Par TOOLPRI= Par-TSMorph-render Triangulate menu item CI-men-E-Triangulate TSMorph Overview TSMorph-prefs TSMorph-prefs TSMorph-prefs Gadgets TSMP-gad TSMorph-prefs menus TSMP-men TSMorph-render Overview Tutorial Overview Two EMode-Two U1 EMode-Unlink U2 EMode-Unlink Undo EModes Unl EMode-Unlink Unlink EMode-Unlink Unsaved project Req-Unsaved Up gadget E-gad-Up Use gadget TSMP-Use Vertical scroll bar E-gad-Vert Width gadget I-gad-Width X Cells gadget Req-Add_Grid-gad-X_Cells Y Cells gadget Req-Add_Grid-gad-Y_Cells Zoom gadget I-gad-Zoom Zoom gadget TSMP-Zoom Zoom gadget E-gad-Zoom ZOOM= Par-TSMorph